Ansible

🚀 SysOperator 項目

SysOperator 是一款功能強大的工具，它能有效簡化 Ansible、Terraform 以及其他基礎設施管理任務的操作流程，讓相關工作變得更加輕鬆高效。

🚀 快速開始

SysOperator 可幫助你輕鬆完成 Ansible、Terraform 等基礎設施管理任務。下面將為你介紹其安裝、配置和使用方法。

✨ 主要特性

• Ansible Playbook 執行：支持執行任意 Ansible Playbook 文件，允許通過 --extra-vars 參數傳遞額外變量，還能指定具體執行的 --tags 或跳過特定 --skip-tags。
• Terraform 操作：提供 init、plan 和 apply 三種操作模式，支持自動審批 (--autoApprove) 以實現 CI/CD 流水線集成，配合 --useLocalstack 參數，可無縫銜接 LocalStack 環境進行測試。
• AWS 操作：原生支持 AWS 服務調用，包括但不限於 EC2、S3 等資源操作，支持通過 --region 參數指定操作區域，結合 LocalStack 使用，可以模擬真實 AWS 環境而不產生實際成本。

📦 安裝指南

方法一：通過 npm 安裝

你可以使用 npm 來全局安裝 SysOperator：

npm install -g sysoperator

方法二：本地運行

如果你不想使用 npm，可以直接從項目倉庫下載源代碼並進行本地構建：

git clone https://github.com/your-repository/sysoperator.git
cd sysoperator
npm install
npm run build

💻 使用示例

基礎用法

快速開始：運行樣例 playbook

node localstack/sample_playbook.mjs

高級用法

Ansible Playbook 執行

sysoperator ansible-playbook \
    --playbook "/path/to/playbook.yml" \
    [--extra-vars "var1=value1 var2=value2"] \
    [--tags "tag1,tag2"] \
    [--skip-tags "skip_tag"]

Terraform 操作

sysoperator terraform \
    --action "init|plan|apply" \
    --workingDir "/path/to/terraform/project" \
    [--autoApprove true|false] \
    [--useLocalstack true|false] \
    [--vars "key1=value1 key2=value2"]

AWS 操作

sysoperator aws \
    --command "describe-instances|launch-instance" \
    --region "us-west-2" \
    [--useLocalstack true|false]

📚 詳細文檔

項目架構

sysoperator/
├── src/
│   ├── index.ts                  # 入口文件
│   └── ansible-mcp-server/       # 當前版本中暫用此命名，後續將改為 sysoperator/
│       ├── index.ts              # SysOperator 核心實現
│       ├── common/               # 公共模塊
│       │   ├── errors.ts         # 錯誤處理
│       │   └── version.ts       # 版本信息
│       └── handlers/            # 操作處理器
│           ├── ansible_handler.ts  # Ansible 處理邏輯
│           ├── terraform_handler.ts # Terraform 處理邏輯
│           └── aws_handler.ts    # AWS 操作處理邏輯
└── localstack/                  # LocalStack 集成模塊
    └── integration.ts          # LocalStack 環境集成實現

本地運行示例

啟動 LocalStack 並執行 playbook

# 啟動 LocalStack
localstack start --exclude docker,ecs,lambda

# 執行 playbook
sysoperator ansible-playbook \
    --playbook localstack/sample_playbook.yml \
    --extra-vars "aws_access_key_id=your_key_id aws_secret_access_key=your_secret" \
    --tags "setup_ec2"

注意事項與限制

• 項目目前處於開發階段，尚未完全成熟。
• 不建議在生產環境中直接使用未經測試的版本。
• 對於複雜場景，可能需要額外的配置和錯誤處理。

錯誤處理

SysOperator 提供了詳細的錯誤日誌輸出機制，用戶可以通過以下方式獲取更多信息：

sysoperator --help

版本信息

當前版本：v1.0.0-rc1

項目倉庫

前往 GitHub 倉庫

免責聲明

此工具目前仍處於開發階段，可能存在不穩定性和潛在風險。在生產環境中使用前，請務必進行全面的測試和驗證。

📄 許可證

<此處應放置具體的許可證內容>