Amazon SSM Agent 项目安装与使用教程

1. 项目目录结构及介绍

Amazon SSM Agent 项目的目录结构如下：

amazon-ssm-agent/
├── Tools/
│   └── src/
├── agent/
├── common/
├── core/
├── extra/
├── internal/
│   └── tests/
├── packaging/
├── src/
├── vendor/
│   └── src/
├── .gitignore
├── .golangci.yml
├── .travis.yml
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── NOTICE.md
├── README.md
├── RELEASENOTES.md
├── VERSION
├── amazon-ssm-agent.json.template
├── amazon-ssm-agent.spec
├── go.mod
├── go.sum
└── makefile

目录介绍

• Tools/src: 包含构建脚本。
• agent: 包含代理工作代码。
• common: 包含IPC等其他功能代码。
• core: 包含核心功能代码，如工作管理。
• extra: 包含额外的功能代码。
• internal/tests: 包含内部测试代码。
• packaging: 包含rpm和dpkg构建的工件。
• src: 包含源代码。
• vendor/src: 包含供应商包的源代码。
• .gitignore: Git忽略文件。
• .golangci.yml: golangci-lint配置文件。
• .travis.yml: Travis CI配置文件。
• CODE_OF_CONDUCT.md: 行为准则文件。
• CONTRIBUTING.md: 贡献指南文件。
• Dockerfile: Docker构建文件。
• LICENSE: 许可证文件。
• NOTICE.md: 通知文件。
• README.md: 项目自述文件。
• RELEASENOTES.md: 发布说明文件。
• VERSION: 版本文件。
• amazon-ssm-agent.json.template: 代理配置模板文件。
• amazon-ssm-agent.spec: 代理规范文件。
• go.mod: Go模块文件。
• go.sum: Go模块校验文件。
• makefile: 构建脚本文件。

2. 项目启动文件介绍

Amazon SSM Agent 的启动文件主要是 amazon-ssm-agent 二进制文件。该文件位于构建完成后生成的 bin 目录下。启动该文件即可启动 SSM Agent。

启动命令示例

./bin/amazon-ssm-agent

3. 项目配置文件介绍

Amazon SSM Agent 的配置文件主要是 amazon-ssm-agent.json 文件。该文件通常位于 /etc/amazon/ssm/ 目录下（Linux）或 C:\ProgramData\Amazon\SSM\ 目录下（Windows）。

配置文件示例

{
  "agent": {
    "name": "amazon-ssm-agent",
    "logfile": "/var/log/amazon/ssm/amazon-ssm-agent.log",
    "region": "us-east-1"
  },
  "ssm": {
    "endpoint": "https://ssm.us-east-1.amazonaws.com"
  }
}

配置项说明

• agent.name: 代理名称。
• agent.logfile: 日志文件路径。
• agent.region: AWS 区域。
• ssm.endpoint: SSM 服务端点。

通过修改配置文件，可以调整 SSM Agent 的行为，如日志路径、AWS 区域等。