brentley/ecsdemo-nodejs

ecsdemo-nodejs 镜像文档

概述

ecsdemo-nodejs 是一个专为 ecsworkshop.com 和 eksworkshop.com 设计的演示镜像，主要用于 AWS ECS (Elastic Container Service) 和 EKS (Elastic Kubernetes Service) 相关工作坊的实践教学与技术演示。该镜像提供了基础的 Node.js 应用示例，帮助用户理解容器化应用在 AWS 容器服务中的部署、运行和管理流程。

核心功能与特性

• 提供基础 Node.js 应用示例，可直接用于演示容器化应用的基本运行机制
• 适配 AWS ECS 和 EKS 环境，支持在工作坊中进行部署练习
• 轻量级设计，便于快速拉取和启动，适合教学演示场景
• 包含基础的应用运行逻辑，可作为工作坊中扩展功能的起点

使用场景与适用范围

• ecsworkshop.com 工作坊：用于学习 ECS 服务的容器部署、任务定义、服务配置等核心概念
• eksworkshop.com 工作坊：用于演示 Kubernetes 集群中的应用部署、服务暴露、负载均衡等操作
• AWS 容器服务初学者：作为入门实践的基础镜像，帮助理解容器化应用与 AWS 服务的集成方式

使用方法与配置说明

基本使用（Docker 运行）

bash
# 拉取镜像（假设镜像来自 AWS ECR 或公共仓库，具体地址需参考工作坊指引）
docker pull amazon/ecsdemo-nodejs

# 运行容器
docker run -d -p 3000:3000 --name ecsdemo-nodejs amazon/ecsdemo-nodejs

运行后，可通过 http://localhost:3000 访问应用。

ECS 部署示例

在 ECS 工作坊中，通常需配合任务定义（Task Definition）使用，示例任务定义片段：

json
{
  "family": "ecsdemo-nodejs",
  "networkMode": "awsvpc",
  "containerDefinitions": [
    {
      "name": "ecsdemo-nodejs",
      "image": "amazon/ecsdemo-nodejs",
      "portMappings": [
        {
          "containerPort": 3000,
          "hostPort": 3000,
          "protocol": "tcp"
        }
      ],
      "essential": true
    }
  ]
}

EKS 部署示例

在 EKS 工作坊中，可通过 Kubernetes Deployment 部署，示例 YAML：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ecsdemo-nodejs
spec:
  replicas: 1
  selector:
    matchLabels:
      app: ecsdemo-nodejs
  template:
    metadata:
      labels:
        app: ecsdemo-nodejs
    spec:
      containers:
      - name: ecsdemo-nodejs
        image: amazon/ecsdemo-nodejs
        ports:
        - containerPort: 3000
---
apiVersion: v1
kind: Service
metadata:
  name: ecsdemo-nodejs
spec:
  selector:
    app: ecsdemo-nodejs
  ports:
  - port: 80
    targetPort: 3000
  type: LoadBalancer

配置说明

该镜像的具体配置（如环境变量、端口映射等）需根据工作坊的实际指引进行调整，通常工作坊会提供详细的部署步骤和参数说明。

注意事项

• 镜像主要用于学习和演示，不建议用于生产环境
• 实际使用时需确保已配置正确的 AWS 访问权限（如 ECR 拉取权限、ECS/EKS 操作权限等）
• 具体镜像版本和仓库地址请以 ecsworkshop.com 或 eksworkshop.com 的最新指引为准