gruntwork/aws-sample-app

Gruntwork参考架构示例应用镜像

镜像概述

本镜像提供了一个示例应用程序，专门设计用于无缝集成并部署到Gruntwork参考架构中。作为Gruntwork生态系统的一部分，该镜像旨在展示标准部署流程、架构最佳实践以及与Gruntwork工具链的兼容性，为开发者提供直观的部署参考和学习资源。

核心功能与特性

• 无缝架构集成：与Gruntwork参考架构深度兼容，支持自动部署流程
• 标准部署示例：提供符合Gruntwork最佳实践的部署配置模板
• 轻量级设计：优化的镜像体积，确保快速部署和资源高效利用
• 可扩展性：模块化结构支持根据实际需求进行功能扩展和定制
• 文档化配置：内置清晰的配置说明，降低集成门槛

使用场景与适用范围

• 架构学习：帮助开发者理解Gruntwork参考架构的部署流程和最佳实践
• 项目模板：作为基于Gruntwork架构开发新应用的基础模板
• 流程验证：用于验证Gruntwork架构部署管道的正确性和稳定性
• 培训演示：在技术培训中展示如何在企业级架构中部署容器化应用

使用方法与配置说明

基本部署

使用以下命令快速启动示例应用容器：

bash
docker run -d \
  --name gruntwork-sample-app \
  -p 8080:8080 \
  gruntwork/sample-app:latest

环境变量配置

与Gruntwork参考架构集成步骤

1. 在Terraform配置中定义服务
   在Gruntwork参考架构的Terraform模块中添加容器服务定义：

   hcl
   module "sample_app" {
     source  = "gruntwork/container-service/aws"
     version = "~> 0.1"
     
     container_image = "gruntwork/sample-app:latest"
     container_port  = 8080
     environment     = {
       GRUNTWORK_ENV = "prod"
       LOG_LEVEL     = "warn"
     }
     # 其他架构特定配置...
   }
   

2. 配置CI/CD管道
   集成到Gruntwork CI/CD管道中，实现自动构建和部署：

   yaml
   # .github/workflows/deploy.yml 示例
   jobs:
     deploy:
       runs-on: ubuntu-latest
       steps:
         - name: Deploy to Gruntwork Architecture
           uses: gruntwork-io/action-deploy@v1
           with:
             service: sample-app
             environment: prod
   

3. 验证部署
   部署完成后，通过Gruntwork架构提供的负载均衡器访问应用：

   bash
   curl http://<load-balancer-dns>/health
   

注意事项

• 确保本地环境已配置Gruntwork CLI工具和相关凭证
• 生产环境部署前需根据实际需求调整资源配置和安全策略
• 详细架构集成文档请参考Gruntwork官方参考架构指南