ideavate/amazonlinux

Amazon Linux 基础工具镜像文档

1. 镜像概述和主要用途

本镜像基于 Amazon Linux 操作系统构建，预装常用基础工具，旨在提供一个稳定、轻量且与 AWS 生态兼容的运行环境。适用于开发、测试、CI/CD 流程及轻量级服务部署，尤其适合需要与 AWS 服务集成的场景。

2. 核心功能和特性

2.1 基础系统特性

• 稳定基础：基于 Amazon Linux（AWS 官方 Linux 发行版），提供长期支持和稳定的系统环境。
• 轻量级设计：优化镜像体积，减少不必要组件，适合资源受限场景。
• 安全更新：集成 Amazon Linux 官方安全补丁和更新，保障基础系统安全性。

2.2 预装基础工具

默认包含以下常用工具（具体版本以镜像标签为准）：

• 网络工具：curl、wget、ping、netstat、dig
• 文件处理：tar、gzip、bzip2、zip、unzip
• 版本控制：git
• 文本编辑：vim、nano
• 系统工具：sudo、yum（包管理器）、systemd（基础服务管理）
• 其他：bash、sh、make、gcc（基础编译工具）

2.3 兼容性与集成

• 与 AWS 服务（如 ECS、EC2、Lambda 等）无缝兼容，支持 IAM 角色、S3 访问等 AWS 功能。
• 支持主流容器编排平台（Docker Compose、Kubernetes）部署。

3. 使用场景和适用范围

3.1 开发环境搭建

• 快速构建本地开发环境，无需手动配置基础工具链。
• 作为多阶段构建中的基础镜像，用于编译或打包应用。

3.2 CI/CD 流程

• 在 CI/CD 管道中作为构建/测试节点，执行代码拉取、依赖安装、编译打包等任务。
• 适用于 Jenkins、GitHub Actions、GitLab CI 等主流 CI/CD 工具。

3.3 轻量级服务部署

• 运行无状态轻量级服务（如静态文件服务、脚本任务等）。
• 作为边缘计算或资源受限环境的基础镜像。

3.4 AWS 环境应用

• 部署需与 AWS 服务（如 SQS、DynamoDB）交互的应用。
• 在 ECS/EKS 中运行微服务或辅助任务。

4. 详细使用方法和配置说明

4.1 获取镜像

默认从 Docker 官方镜像源拉取（若未指定私有仓库）：

bash
docker pull amazonlinux-base-tools:latest  # 假设镜像标签为 latest

4.2 基本运行命令

4.2.1 启动容器（后台模式）

bash
docker run -d --name amazonlinux-demo amazonlinux-base-tools:latest

4.2.2 交互模式运行（进入容器终端）

bash
docker run -it --rm amazonlinux-base-tools:latest /bin/bash

• -it：启用交互终端并分配伪终端
• --rm：容器退出后自动删除（临时测试场景推荐）

4.2.3 挂载本地目录（数据持久化）

将本地目录挂载到容器内，实现文件共享：

bash
docker run -v /本地目录:/容器内目录 amazonlinux-base-tools:latest

示例（挂载当前目录到容器 /app）：

bash
docker run -it -v $(pwd):/app amazonlinux-base-tools:latest /bin/bash

4.3 环境变量配置

通过 -e 参数设置环境变量，例如配置时区、代理等：

bash
# 设置时区为 Asia/Shanghai
docker run -e TZ=Asia/Shanghai amazonlinux-base-tools:latest

# 配置 HTTP 代理
docker run -e HTTP_PROXY=http://proxy.example.com:8080 amazonlinux-base-tools:latest

4.4 自定义工具安装

如需扩展工具，可通过 yum 包管理器安装（需 root 权限，默认用户为 root）：

bash
# 示例：安装 Python3
docker run -it amazonlinux-base-tools:latest /bin/bash -c "yum update -y && yum install -y python3"

4.5 Docker Compose 配置示例

创建 docker-compose.yml 定义服务：

yaml
version: '3'
services:
  amazonlinux-service:
    image: amazonlinux-base-tools:latest
    container_name: my-amazonlinux-service
    tty: true  # 保持终端活跃
    volumes:
      - ./data:/app/data  # 挂载数据卷
    environment:
      - TZ=Asia/Shanghai
      - APP_ENV=production
    command: /bin/bash -c "echo 'Service started' && tail -f /dev/null"  # 保持服务运行

启动服务：

bash
docker-compose up -d

5. 配置参数与环境变量

5.1 默认配置

5.2 常用环境变量

6. 注意事项

• 镜像更新：建议定期拉取最新标签（如 latest）以获取安全补丁和工具更新。
• 非 root 用户运行：生产环境推荐通过 --user 指定低权限用户，降低安全风险：

  bash
  docker run --user 1000:1000 amazonlinux-base-tools:latest
  

• AWS 权限配置：若需访问 AWS 服务，可通过挂载 AWS 凭证文件（~/.aws/credentials）或配置 IAM 角色（ECS/EKS 环境）实现授权。
• 镜像体积控制：自定义构建时建议清理 yum cache 以减小镜像体积：

  dockerfile
  RUN yum install -y python3 && yum clean all && rm -rf /var/cache/yum
  

7. 总结

本镜像提供了基于 Amazon Linux 的稳定基础环境，集成常用工具链，适合快速部署轻量级服务或构建开发/CI 环境。通过灵活的配置（环境变量、卷挂载、自定义工具安装），可适配多种使用场景，尤其推荐在 AWS 生态中使用。