使用Terraform配置日志审计服务

使用Terraform的优势

• 支持同时部署基础结构至多个云

  Terraform适用于多云方案，将类似的基础结构部署到阿里云、其他云厂商或者本地数据中心。开发人员能够使用相同的工具和相似的配置文件同时管理不同云厂商的资源。

• 基础结构自动化管理

  您可以使用Terraform创建配置文件模板，用于重复、可预测的方式定义、预配和配置ECS资源，减少因人为因素导致的部署和管理错误。您可以多次部署同一模板，创建相同的开发、测试和生产环境。

• 基础架构即代码（Infrastructure as Code）

  Terraform支持通过代码来管理、维护资源，允许保存基础设施状态，从而使您能够跟踪对系统（基础设施即代码）中不同组件所做的更改，并与其他人共享这些配置。

• 开发成本降低

  可通过按需创建开发和部署环境降低开发成本。并且，您可以在系统更改之前进行开发成本评估。

步骤一：配置身份信息以及日志审计服务的中心化地域

在环境变量中配置用户身份信息以及日志审计服务的中心Project所在地域。

export ALICLOUD_ACCESS_KEY="AccessKey ID"
export ALICLOUD_SECRET_KEY="AccessKey Secret"
export ALICLOUD_REGION="cn-huhehaote"

步骤二：RAM授权

对于中心账号，如果不存在AliyunServiceRoleForSLSAudit关联角色，则需先创建该关联角色。具体操作，请参见首次配置。

如果需要通过自定义鉴权模式配置其他成员账号，则在授权中所涉及的权限策略信息请参见自定义授权日志采集与同步。

步骤三：配置日志审计服务

1. 创建一个Terraform工作目录（例如名为sls的工作目录），并在该目录下创建一个名为terraform.tf的文件。
2. 在terraform.tf文件中，添加如下内容。

   resource "alicloud_log_audit" "example" {
     display_name = "tf-audit-test"
     aliuid       = "1379186349****"
   }

   相关参数说明如下：

   参数	说明
   example	Resource名称。自定义配置。
   display_name	采集配置名称。自定义配置。
   aliuid	阿里云账号ID。

3. 在您所创建的工作目录sls下，执行如下命令，初始化terraform工作目录。

   terraform init

   如果返回结果中提示Terraform has been successfully initialized!，表示初始化成功。
4. 编辑terraform.tf文件，配置日志审计服务相关参数。

   配置示例如下。Terraform中日志审计采集配置的完整参数说明，请参见Terraform-Aliyun Log Audit。

   • 单账号采集

     resource "alicloud_log_audit" "example" {
       display_name = "tf-audit-test"
       aliuid       = "1379186349****"
       variable_map = {
         "actiontrail_enabled" = "true",
         "actiontrail_ttl" = "180"
       }
     }

   • 多账号采集

     您可以通过自定义鉴权管理模式（中心账号为普通账号）或资源目录管理模式（中心账号必须为管理账号或者委派管理员账号）配置多账号采集。更多信息，请参见配置多账号采集。

     • 自定义鉴权管理模式

       resource "alicloud_log_audit" "example" {
         display_name = "tf-audit-test"
         aliuid     = "1379186349****"
         variable_map = {
           "actiontrail_enabled" = "true",
           "actiontrail_ttl" = "180"
         }
         multi_account = ["1257918632****", "1324567349****"]
       
       }

     • 资源目录管理模式（自定义方式）

       resource "alicloud_log_audit" "example" {
         display_name = "tf-audit-test"
         aliuid    = "1379186349****"
         variable_map = {
           "actiontrail_enabled" = "true",
           "actiontrail_ttl" = "180"
         }
         multi_account = ["1257918632****", "1324567349****"]
       resource_directory_type="custom"
       }

     • 资源目录管理模式（全员方式）

       resource "alicloud_log_audit" "example" {
         display_name = "tf-audit-test"
         aliuid       = "1379186349****"
         variable_map = {
           "actiontrail_enabled" = "true",
           "actiontrail_ttl" = "180"
         }
       resource_directory_type="all"
       }

   重要参数说明如下表所示。

   参数	说明
   multi_account	采用资源目录管理的自定义模式或自定义鉴权管理模式配置多账号采集时，需配置multi_account参数。 说明 自定义鉴权管理模式配置复杂，推荐您使用资源目录管理模式进行多账号配置。 自定义鉴权管理模式（resource_directory_type参数不存在）：配置multi_account为阿里云账号ID。 资源目录管理的自定义模式（resource_directory_type=custom）：配置multi_account为资源目录中的成员。
   resource_directory_type	采用资源目录管理模式配置多账号采集时，需配置resource_directory_type参数。取值： all：采用资源目录管理的全员模式。 custom：采用资源目录管理的自定义模式。 说明 如果是采用自定义鉴权管理模式，无需添加resource_directory_type参数。
   variable_map	采集对象、是否采集以及存储时间等相关设置。variable_map参数列表，请参见附录：variable_map参数列表。

5. 使terraform.tf文件中的采集配置生效。
   1. 执行如下命令。

      terraform apply

   2. 输入yes。

      如果返回结果中提示Apply complete!，表示应用采集配置成功，日志审计服务将按照采集配置进行日志采集和存储。

      

相关操作

您还可以通过Terraform完成如下相关操作。

• 导入已有采集配置。

  terraform import alicloud_log_audit.example tf-audit-test

  其中，example和tf-audit-test，请根据实际情况替换。

  

  执行完毕后，您可以查看terraform工作目录下的terraform.tfstate文件内容。terraform.tfstate文件内容即为导入的采集配置。

  重要

  • 如果您想要将导入的采集配置迁移到terraform.tf文件中，需要手动拷贝，并对格式做适当调整，满足terraform.tf文件的格式要求。
  • 如果您已经在当前的terraform工作目录执行过terrraform apply或者terraform import命令，则此时再次执行terraform import命令会失败。您需要删除当前目录下的terraform.tfstate文件后再重新执行terraform import命令。
• 查看当前采集配置。

  terraform show

  
• 查看当前terraform工作目录下的terraform.tf文件与已生效的采集配置的差异。

  terraform plan

  

示例

accept tag.env == "test"
drop "*"

附录：variable_map参数列表