Harness aws-cdk-plugin 镜像文档

镜像概述

本镜像为Harness平台提供aws-cdk-plugin相关支持，包含基础镜像及针对不同技术栈的自定义镜像。基础镜像构建了AWS CDK运行的基础环境，而自定义镜像则针对Java、.NET、Python、Go等主流技术栈进行了环境优化，确保在Harness平台中高效执行AWS CDK相关的部署与管理操作。

核心功能与特性

1. 基础镜像功能

• 内置AWS CDK基础运行环境，包含必要的依赖库与工具
• 支持AWS账户认证配置，集成AWS CLI基础功能
• 提供标准化的Harness插件接口，确保与Harness平台无缝集成

2. 多技术栈支持

• Java栈：预装JDK、Maven/Gradle及AWS CDK Java SDK
• .NET栈：包含.NET SDK、NuGet及AWS CDK .NET SDK
• Python栈：集成Python环境、pip及AWS CDK Python SDK
• Go栈：内置Go编译器、模块管理工具及AWS CDK Go SDK

3. 平台集成特性

• 支持Harness变量注入，便于配置管理
• 兼容Harness CI/CD流水线，可直接作为插件步骤集成
• 提供日志标准化输出，便于Harness平台日志收集与分析

使用场景与适用范围

适用场景

• Harness用户在AWS环境中使用AWS CDK进行基础设施即代码（IaC）部署
• 不同技术栈开发团队（Java、.NET、Python、Go）在Harness平台中执行CDK模板验证、合成与部署
• CI/CD流水线中集成AWS CDK操作，实现基础设施自动化部署

适用范围

• Harness平台用户
• 使用AWS CDK进行云资源管理的开发/运维团队
• 采用Java、.NET、Python或Go技术栈的AWS CDK项目

使用方法与配置说明

镜像拉取

基础镜像及各技术栈自定义镜像可通过以下命令拉取（具体镜像标签需根据版本指定）：

# 拉取基础镜像
docker pull harness/aws-cdk-plugin:base-latest

# 拉取技术栈自定义镜像（以Java为例）
docker pull harness/aws-cdk-plugin:java-latest
# .NET
docker pull harness/aws-cdk-plugin:dotnet-latest
# Python
docker pull harness/aws-cdk-plugin:python-latest
# Go
docker pull harness/aws-cdk-plugin:go-latest

环境变量配置

运行镜像时可通过环境变量进行配置，常用环境变量如下：

基础使用示例（docker run）

以Java技术栈自定义镜像为例，执行AWS CDK部署命令：

docker run -it --rm \
  -e AWS_ACCESS_KEY_ID="AKIAEXAMPLE" \
  -e AWS_SECRET_ACCESS_KEY="secretExample" \
  -e AWS_REGION="us-east-1" \
  -v /path/to/cdk-project:/app \
  harness/aws-cdk-plugin:java-latest \
  cdk deploy --app /app

Harness流水线集成示例

在Harness CI/CD流水线中作为插件步骤集成（YAML片段）：

steps:
  - step:
      name: Deploy with AWS CDK (Java)
      identifier: cdk_deploy
      type: Plugin
      spec:
        connectorRef: docker-hub-connector
        image: harness/aws-cdk-plugin:java-latest
        command: cdk deploy --app /harness/workspace
        envVariables:
          - name: AWS_ACCESS_KEY_ID
            value: <+secrets.getValue("aws-access-key")>
          - name: AWS_SECRET_ACCESS_KEY
            value: <+secrets.getValue("aws-secret-key")>
          - name: AWS_REGION
            value: us-west-2

各技术栈自定义镜像使用说明

• Java：项目需包含pom.xml或build.gradle，执行命令示例：cdk synth --app mvn package
• .NET：项目需包含.csproj文件，执行命令示例：cdk deploy --app dotnet run
• Python：推荐使用虚拟环境，执行命令示例：cdk bootstrap --app "python app.py"
• Go：项目需包含go.mod，执行命令示例：cdk diff --app "go run main.go"

注意事项

• 确保AWS凭证具有足够权限执行目标CDK操作
• 不同技术栈自定义镜像需匹配对应项目的构建环境要求
• 生产环境建议指定具体版本标签（如java-2.100.0）而非latest，确保环境一致性