lcloud/ci

LCloud Ltd CI 镜像文档

镜像概述

LCloud Ltd CI是一个集成了多种开发、运维工具的持续集成(CI)运行器，专为简化云服务开发流程设计。该镜像预装了丰富的AWS云服务工具、编程语言环境及基础设施即代码(IaC)检查工具，可直接用于自动化构建、测试和部署流程，减少CI环境配置成本。

核心功能与特性

编程语言环境

• Python (v3.9)：支持Python应用开发及脚本运行
• Node.js (v18)：满足JavaScript/TypeScript项目构建需求
• Ruby (v3.2)：支持Ruby脚本及相关工具运行

AWS专用工具

• AWS CLI v2：与AWS服务交互的命令行工具
• AWS SAM CLI：AWS Serverless应用模型(SAM)的构建、测试与部署工具
• CloudFormation Guard：CloudFormation模板策略验证工具

CloudFormation生态工具

• cfn-tools：CloudFormation辅助工具集
• cfn-lint：CloudFormation模板语法及最佳实践检查工具
• cfn-flip：CloudFormation模板格式转换工具（JSON/YAML互转）
• taskcat：CloudFormation模板测试框架
• rain：CloudFormation命令行工具（模板验证、打包等）

Serverless开发支持

• Serverless Framework (v3)：跨云提供商的Serverless应用开发与部署框架

基础设施即代码(IaC)检查工具

• cfn_nag：静态分析CloudFormation模板以识别安全违规
• tenv：Terraform环境变量管理工具
• tflint：Terraform代码检查工具（语法、最佳实践）
• tf-unused：检测未使用的Terraform资源

基础实用工具

• curl、jq、unzip、wget、zip：满足文件处理、网络请求等日常操作需求

使用场景与适用范围

• AWS云服务项目的CI/CD流程：包括CloudFormation模板验证、SAM应用构建部署、Serverless应用发布
• 基础设施即代码合规性检查：通过cfn-lint、cfn_nag、tflint等工具实现IaC质量管控
• 多语言混合项目构建：同时支持Python、Node.js、Ruby环境的CI任务
• DevOps自动化流程：适用于GitLab CI、GitHub Actions、Jenkins等主流CI/CD平台

使用方法与配置说明

基本运行

直接启动容器验证环境：

bash
docker run --rm lcloud/lci:latest

在CI配置中集成

GitLab CI/CD示例（.gitlab-ci.yml）

yaml
stages:
  - validate
  - build
  - deploy

validate-iac:
  stage: validate
  image: lcloud/lci:latest
  script:
    - cfn-lint cloudformation/*.yml          # 验证CloudFormation模板
    - tflint terraform/                       # 检查Terraform代码
    - cfn_nag cloudformation/prod-template.yml # CloudFormation安全检查

build-sam-app:
  stage: build
  image: lcloud/lci:latest
  script:
    - sam build --template cloudformation/sam-template.yml  # 构建SAM应用
    - zip -r build-output.zip .aws-sam/build/                # 打包构建产物

deploy-to-aws:
  stage: deploy
  image: lcloud/lci:latest
  script:
    - aws configure set aws_access_key_id $AWS_ACCESS_KEY    # 配置AWS凭证
    - aws configure set aws_secret_access_key $AWS_SECRET_KEY
    - sam deploy --stack-name my-sam-app --no-confirm-changeset
  only:
    - main

GitHub Actions示例（.github/workflows/ci.yml）

yaml
name: CI Pipeline
on: [push]

jobs:
  validate:
    runs-on: ubuntu-latest
    container: lcloud/lci:latest
    steps:
      - uses: actions/checkout@v4
      - name: Validate CloudFormation
        run: cfn-lint template.yml
      - name: Check Serverless config
        run: serverless info

本地开发调试

挂载本地项目目录进行工具测试：

bash
# 挂载当前目录到容器/workspace并执行SAM构建
docker run --rm -v $(pwd):/workspace -w /workspace lcloud/lci:latest sam build

# 使用cfn-lint检查本地模板
docker run --rm -v $(pwd):/workspace -w /workspace lcloud/lci:latest cfn-lint template.yml