为虚拟机创建 Terraform 部署模块

本页介绍了如何为虚拟机 (VM) 创建虚拟机和 Terraform 部署模块。

创建许可的虚拟机映像

  1. 为确保开发虚拟机不受影响,请运行以下 gcloud 命令,创建虚拟机中所用磁盘的副本:
    gcloud compute disks create CLONE_DISK \ --description="cloned disk" \ --source-disk=projects/PROJECT/zones/ZONE/disks/SOURCE_VM_DISK
  2. 创建虚拟机的克隆。如需了解详情,请参阅创建一个与现有虚拟机类似的虚拟机
  3. 高级选项部分中,挂接克隆的磁盘。
  4. 创建虚拟机。
  5. 验证此虚拟机的服务器是否正在运行。启动脚本可确保虚拟机正在运行。
  6. 在 Docker 中停止并移除 connector-service。
  7. 移除主目录以及运行服务器不需要的任何其他文件。系统将使用同一磁盘创建虚拟机映像,客户稍后将能够访问该映像。此虚拟机只能包含运行服务所需的库。
  8. 修改虚拟机,并将删除规则设为保留磁盘
  9. 删除此虚拟机。
  10. 如需创建许可映像,请从生产者门户获取许可。访问 Producer Portal
  11. 创建新的虚拟机产品。前往部署包部分,然后复制虚拟机许可。
  12. 如需创建许可的虚拟机映像,请运行以下命令:
  13. gcloud compute images create VM_IMAGE_NAME \
     --project PUBLIC_PROJECT_NAME \
     --source-disk projects/DEV_PROJECT_NAME/zones/ZONE/disks/SOURCE_VM_DISK \
     --licenses LICENSE \
     --description VM_IMAGE_DESCRIPTION

    如需了解详情,请参阅构建虚拟机

创建 Terraform 部署模块

Marketplace 提供了 Autogen 工具,用于生成 Terraform 模块,以便在 Marketplace 上部署虚拟机映像。

此工具使用 Autogen proto 定义生成部署。如需了解详情,请参阅配置示例

  1. 添加解决方案的详细信息:
  2. solutionInfo:
      name: 
      packagedSoftwareGroups:
        - type: SOFTWARE_GROUP_OS
          components:
            - name: Ubuntu
              version: 16.04 LTS
        - components:
            - name: Apache
              version: 2.4.23
  3. 对于连接器,请使用虚拟机创建模块。在公共项目中为映像输入项目名称、虚拟机映像名称和标签
  4. 将 n2d-standard-2 用作默认机器类型,将 CPU 最小值设为 2,将 RAM 设为 8 GB。N2d-standard 最适合中等流量的 Web 服务器。默认虚拟机可以设置为 2 核。如果客户希望获得更高的流量,可以在 Marketplace 中创建虚拟机时更改此值。如需了解不同机器类型的价格,请参阅虚拟机实例价格
        machineType:
          # Check http://cloud.google.com/compute/docs/machine-types for all available types
          defaultMachineType:
            gceMachineType: n2d-standard-2
          # Minimum CPU and memory constraints for the machine type to run your solution properly
          minimum:
            cpu: 2
            ramGb: 8
  5. 使用 pd-standard 作为默认磁盘类型。
        bootDisk:
          diskType:
            defaultType: pd-standard
  6. 将启动脚本添加到 autogen 配置。将启动脚本转换为字符串,并将其添加到 bashScriptContent 中。
    gceStartupScript:
       bashScriptContent: 
  7. 定义在创建虚拟机期间将从客户获取输入的输入字段。
        deployInput:
          sections:
            # The place int he Deployment Manager config that this section will appear. More details in deployment_package_autogen_spec.proto
            - placement: CUSTOM_TOP
              name: CONNECTOR_SETTINGS
              title: Connectors settings
              description: Connectors settings
              tooltip: Setting with which connector VM will be running
              # List of input fields that this section has
              fields:
                - required: false
                  name: TEST_DATA
                  title: Test Data
                  description: Test data
                  tooltip: random data for testing
                  string_box: {}
                - required: false
                  name: PORT
                  title: Port to run service
                  tooltip: Port to run connector service
                  string_box: {}
                - required: false
                  name: LOG_LEVEL
                  title: Log level
                  description: Log level for the web service. Allowed values are DEBUG, INFO, WARNING, ERROR. Default is INFO
                  string_box: {}

    将展示位置保持为 CUSTOM_TOP,并将名称设为 CONNECTOR_SETTINGS

    定义字段以及所需的输入类型。在此示例中,Marketplace 连接器的客户会看到测试数据用于运行服务的端口字段。

  8. 定义 Compute Engine 元数据项。在定义虚拟机元数据时。将输入字段的名称映射到元数据键。
        gce_metadata_items:
          - key: CONNECTOR_ENV_PORT
            value_from_deploy_input_field: PORT
          - key: CONNECTOR_ENV_TEST_DATA
            value_from_deploy_input_field: TEST_DATA
    - key: CONNECTOR_ENV_LOG_LEVEL
            value_from_deploy_input_field: LOG_LEVEL
  9. 添加将在部署后向客户显示的步骤详情。
        postDeploy:
          # List of suggested action items for users, after deployment is successful
          actionItems:
            - heading: Create the Private service attachment
              description: Now the connector service is running on the VM, please create the PSC service attachment to create the connection. Follow https://cloud.google.com/integration-connectors/docs/configure-psc for the detailed guide.
            - heading: Create the connection
              description: After creating the connectors endpoint attachment, use the endpoint attachment to create a connection to the partner connector.
  10. 如需设置 autogen,请运行以下命令:
    alias autogen='docker run \
      --rm \
      --workdir /mounted \
      --mount type=bind,source="$(pwd)",target=/mounted \
      --user $(id -u):$(id -g) \
      gcr.io/cloud-Marketplace-tools/dm/autogen'
    
    autogen --help
  11. 如需生成 Terraform 模块,请运行以下命令:
    mkdir solution_folder
    
    autogen \
      --input_type YAML \
      --single_input example-config/solution.yaml \
      --output_type PACKAGE \
      --output solution_folder

    solution_folder 包含 terraform 模块。在 Marketplace 上发布商品时,系统会使用此模块。

后续步骤