1.3. 从其他版本进行迁移

流程

1. 从 cloud.terraform 模块中复制您的自动化任务。

   示例

   - name: Create configuration version with auto_queue_runs to false
     hashicorp.terraform.configuration_version:
      workspace_id: ws-1234
      configuration_files_path: "/usr/home/tf"
      auto_queue_runs: false
      tf_validate_certs: true
      poll_interval: 3
      poll_timeout: 15
      state: present

2. 配置以下所需参数：

   • workspace_id 或 workspace + organization ： 将创建配置版本的工作区 ID 或工作区名称和组织，该文件将被上传（表示 state: present）。

   • configuration_files_path ： 上传所需 Terraform Enterprise 或 HCP Terraform 文件的路径来创建配置版本（用于 state: present）。模块接受 configuration_files_path 的两个文件类型：

     • 目录： 包含 Terraform Enterprise 或 HCP Terraform 文件的任何文件夹。模块会自动从所有内容中自动创建 .tar.gz 文件。
     • .tar.gz Archive: Pre-compressed gzip tarball.模块验证 TAR 格式和 gzip 压缩。

   • configuration_version_id ： 要存档的配置版本 ID (状态： archive)。此操作会删除关联的上传的 .tar.gz 文件。注意以下几点：

     • 仅上传使用 API 或 CLI 创建的版本，没有活跃的运行，且不是任何工作区的当前版本可以被归档。
     • 如果未指定 configuration_version_id，Terraform Enterprise 或 HCP Terraform 在工作区中选择最新的批准的 configuration_version_id。
   • auto_queue_runs ： 确定 Terraform Enterprise 或 HCP Terraform 是否在配置上传后自动启动（默认为true ），或者需要手动启动(false)。
3. 根据需要设置其他 可选参数。

流程

1. 创建 run 模块。

   示例

   - name: Create a destroy run with auto_apply
     hashicorp.terraform.run:
     workspace_id: ws-1234
     run_message: "destroy vpc"
     state: "present"
     tf_token: <your token>
     is_destroy: true
     auto_apply: true
     target_addrs:
       - "aws_vpc.vpc1"
       - "aws_vpc.vpc2"
     poll: true
     poll_interval: 10
     poll_timeout: 30

2. 配置以下所需参数：

   • workspace_id 或 workspace + organization ： 将创建配置版本的工作区 ID 或工作区名称和组织，该文件将被上传（表示 state: present）。
   • run_id ： 要应用、取消或丢弃操作的目标的唯一标识符。
   • tf_token: Terraform API 身份验证令牌。如果没有设置这个值，则使用 TF_TOKEN 环境变量。

3. （可选）配置内置的轮询选项，以确定 Terraform Enterprise 或 HCP Terraform 操作的等待周期完成：

   • poll: true ：（默认）每 poll_interval 秒（默认为 5s）检查运行状态，直到达到 completion 或 poll_timeout (default: 25s)为止，返回最终状态。
   • poll: false : 在启动运行后立即返回，而不等待。
4. 根据需要设置其他 可选参数。

流程

1. 要防止针对 TFE 或 HCP Terraform 运行 playbook 时的错误，请在运行 playbook 前执行以下操作：

   1. 确认执行环境中的 Terraform 版本与 TFE 或 HCP Terraform 中声明的版本相同。

   2. 在 TFE 或 HCP Terraform 中执行初始化：

      terraform init

   3. 如果您在执行环境中有一个本地状态文件，请删除本地状态文件。
   4. 从 HCP Terraform 或 Terraform Enterprise 获取令牌，您将用来在后续步骤中创建凭证。确保令牌具有必要的权限，基于团队或用户令牌在 playbook 中执行所需的功能。
   5. 从 playbook 定义中删除后端配置文件和文件。

   6. 如果要在 TF 配置中的默认设置或环境变量中添加工作区，如果要定义在更新 playbook 本身外的工作空间。

      注意

      您可以将工作区添加到 playbook 中，以扩展工作空间利用率。

2. 在 Ansible Automation Platform 用户界面中：

   1. 创建凭据。
   2. 在 Ansible Automation Platform 中构建执行环境。
   3. 创建并启动作业模板。

3. （可选）在迁移完成后，您可以从执行环境中的集合运行额外的模块和插件：

   • plan Stash 模块
   • Terraform 模块
   • 输出插件
   • 输出查找插件
   • State 清单插件