From 3ff5d8a651cea7455d9cca291f56a86cda4f05ae Mon Sep 17 00:00:00 2001 From: Bouhmadi Kacem Date: Fri, 22 Nov 2024 16:40:53 +0100 Subject: [PATCH] Document how to update Agentless CloudFormation and Terraform versions (#26353) * Document how to update Agentless cloudformation and terraform versions * Apply suggestions from code review Co-authored-by: Moez Ezzeddine * Apply suggestions from code review Co-authored-by: Moez Ezzeddine * Improve the CloudFormation documentation * Improve CFN doc Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --------- Co-authored-by: Moez Ezzeddine Co-authored-by: Janine Chan <64388808+janine-c@users.noreply.github.com> --- .../setup/agentless_scanning/cloudformation.md | 12 +++++++++++- .../setup/agentless_scanning/quick_start.md | 12 +++++++++++- .../setup/agentless_scanning/terraform.md | 8 +++++++- 3 files changed, 29 insertions(+), 3 deletions(-) diff --git a/content/en/security/cloud_security_management/setup/agentless_scanning/cloudformation.md b/content/en/security/cloud_security_management/setup/agentless_scanning/cloudformation.md index 609a2a4d215c2..6bb9baee97338 100644 --- a/content/en/security/cloud_security_management/setup/agentless_scanning/cloudformation.md +++ b/content/en/security/cloud_security_management/setup/agentless_scanning/cloudformation.md @@ -53,6 +53,15 @@ If you've already [set up Cloud Security Management][3] and want to add a new AW {{% csm-agentless-exclude-resources %}} +## Update the CloudFormation stack + +Datadog recommends updating the CloudFormation stack regularly, so you can get access to new features and bug fixes as they get released. To do so, follow these steps: +1. Log in to your AWS console and go to the CloudFormation Stacks page. +2. Select the **DatadogIntegration-DatadogAgentlessScanning-...** CloudFormation sub-stack, click **Update**, then click **Update nested stack**. +3. Click **Replace existing template**. +4. In the following S3 URL: `https://datadog-cloudformation-template-quickstart.s3.amazonaws.com/aws//datadog_agentless_scanning.yaml`, replace `` with the version found in [aws_quickstart/version.txt][4]. Paste that URL into the **Amazon S3 URL** field. +5. Click **Next** to advance through the next several pages without modifying them, then submit the form. + ## Disable Agentless Scanning 1. On the [Cloud Security Management Setup][3] page, click **Cloud Integrations** > **AWS**. @@ -69,4 +78,5 @@ To uninstall Agentless Scanning, log in to your AWS console and delete the Cloud [1]: /security/cloud_security_management/agentless_scanning [2]: /security/cloud_security_management/setup/agentless_scanning/terraform -[3]: https://app.datadoghq.com/security/configuration/csm/setup \ No newline at end of file +[3]: https://app.datadoghq.com/security/configuration/csm/setup +[4]: https://github.com/DataDog/cloudformation-template/blob/master/aws_quickstart/version.txt diff --git a/content/en/security/cloud_security_management/setup/agentless_scanning/quick_start.md b/content/en/security/cloud_security_management/setup/agentless_scanning/quick_start.md index d63a97cc75292..6d4aa7e9f5974 100644 --- a/content/en/security/cloud_security_management/setup/agentless_scanning/quick_start.md +++ b/content/en/security/cloud_security_management/setup/agentless_scanning/quick_start.md @@ -33,6 +33,15 @@ Designed for new users, the quick start workflow offers an efficient setup proce {{% csm-agentless-exclude-resources %}} +## Update the CloudFormation stack + +Datadog recommends updating the CloudFormation stack regularly, so you can get access to new features and bug fixes as they get released. To do so, follow these steps: +1. Log in to your AWS console and go to the CloudFormation Stacks page. +2. Select the **DatadogIntegration-DatadogAgentlessScanning-...** CloudFormation sub-stack, click **Update**, then click **Update nested stack**. +3. Click **Replace existing template**. +4. In the following S3 URL: `https://datadog-cloudformation-template-quickstart.s3.amazonaws.com/aws//datadog_agentless_scanning.yaml`, replace `` with the version found in [aws_quickstart/version.txt][11]. Paste that URL into the **Amazon S3 URL** field. +5. Click **Next** to advance through the next several pages without modifying them, then submit the form. + ## Disable Agentless Scanning 1. On the [Cloud Security Management Setup][10] page, click **Cloud Integrations** > **AWS**. @@ -55,4 +64,5 @@ To uninstall Agentless Scanning, log in to your AWS console and delete the Cloud [7]: mailto:success@datadoghq.com [8]: mailto:success@datadoghq.com [9]: https://github.com/DataDog/terraform-module-datadog-agentless-scanner/blob/main/README.md#uninstall -[10]: https://app.datadoghq.com/security/configuration/csm/setup \ No newline at end of file +[10]: https://app.datadoghq.com/security/configuration/csm/setup +[11]: https://github.com/DataDog/cloudformation-template/blob/master/aws_quickstart/version.txt diff --git a/content/en/security/cloud_security_management/setup/agentless_scanning/terraform.md b/content/en/security/cloud_security_management/setup/agentless_scanning/terraform.md index 80846c378488c..2b99f764ae2e2 100644 --- a/content/en/security/cloud_security_management/setup/agentless_scanning/terraform.md +++ b/content/en/security/cloud_security_management/setup/agentless_scanning/terraform.md @@ -64,6 +64,12 @@ If you've already set up Cloud Security Management and want to add a new AWS acc Follow the instructions for [Terraform][3] uninstallation. +## Update the Terraform modules version + +Update the `source` reference for the Agentless Scanner modules to the latest release. You can find the latest version on [GitHub Releases](https://github.com/DataDog/terraform-module-datadog-agentless-scanner/releases). + +For usage examples, refer to our [Github repository](https://github.com/DataDog/terraform-module-datadog-agentless-scanner/tree/main/examples). + ## Further Reading {{< partial name="whats-next/whats-next.html" >}} @@ -71,4 +77,4 @@ Follow the instructions for [Terraform][3] uninstallation. [1]: /security/cloud_security_management/agentless_scanning [2]: /security/cloud_security_management/setup/agentless_scanning/cloudformation [3]: https://github.com/DataDog/terraform-module-datadog-agentless-scanner/blob/main/README.md#uninstall -[4]: https://app.datadoghq.com/security/configuration/csm/setup \ No newline at end of file +[4]: https://app.datadoghq.com/security/configuration/csm/setup