digitalgaz/solidfire

powercli-aws-solidfire 镜像文档

镜像概述与主要用途

powercli-aws-solidfire 是一个集成了 PowerCLI 核心环境及 AWS.netcore、Solidfire.core 模块的 Docker 镜像。该镜像旨在为用户提供一站式跨平台自动化管理工具，支持同时对 VMware 虚拟化环境、AWS 云资源及 SolidFire 存储系统进行统一脚本化管理与操作。

核心功能与特性

基础功能

• PowerCLI 环境：内置 PowerCLI 核心模块，支持 VMware vSphere、vCenter 等虚拟化平台的自动化管理（如虚拟机生命周期、资源池配置、快照管理等）。

集成模块

• AWS.netcore：预安装 AWS .NET Core 相关 PowerShell 模块，支持 AWS 云资源（如 EC2、S3、IAM 等）的管理、监控与自动化操作。
• Solidfire.core：预安装 NetApp SolidFire 存储系统 PowerShell 模块，支持 SolidFire 集群配置、卷管理、性能监控等存储资源操作。

跨平台支持

• 基于 Docker 容器化部署，支持 Linux、Windows、macOS 等主流操作系统，无需在宿主机单独配置 PowerShell 环境及模块依赖。

自动化能力

• 支持批量执行 PowerShell 脚本，可集成至 CI/CD 流水线或定时任务，实现基础设施即代码（IaC）场景下的自动化运维。

使用场景与适用范围

典型场景

1. 混合云环境管理：同时管理 VMware 私有云与 AWS 公有云资源，实现跨平台资源编排（如虚拟机部署、网络配置同步）。
2. 存储与计算联动：通过 Solidfire.core 模块将 SolidFire 存储卷与 VMware/AWS 计算资源（虚拟机、EC2 实例）联动配置，优化存储性能。
3. 多平台脚本测试：在统一环境中调试涉及 VMware、AWS、SolidFire 的复合脚本，避免本地环境依赖冲突。
4. CI/CD 基础设施管理：在流水线中集成该镜像，通过脚本自动化完成部署前的资源检查、环境初始化等操作。

适用用户

• 混合云运维工程师、DevOps 工程师、云平台架构师及需要跨 VMware、AWS、SolidFire 平台进行自动化管理的技术团队。

使用方法与配置说明

获取镜像

假设镜像托管于 Docker Hub（实际使用时需替换为具体仓库地址）：

bash
docker pull [镜像仓库地址]/powercli-aws-solidfire:latest

基本使用（docker run 命令）

1. 执行单脚本任务

直接运行容器并执行指定脚本（脚本内容需包含 PowerCLI、AWS 或 SolidFire 相关操作）：

bash
docker run --rm \
  [镜像仓库地址]/powercli-aws-solidfire:latest \
  pwsh -File /path/to/script.ps1

注：若脚本需访问外部资源（如 vCenter、AWS API、SolidFire 集群），需确保容器网络可连通目标服务。

2. 交互模式运行

进入容器的 PowerShell 交互环境，手动执行命令或调试脚本：

bash
docker run -it --rm \
  [镜像仓库地址]/powercli-aws-solidfire:latest \
  pwsh

挂载本地脚本目录

将宿主机的脚本目录挂载至容器，便于直接运行本地开发的脚本：

bash
docker run -it --rm \
  -v /本地脚本目录:/scripts \  # 挂载宿主机目录至容器内 /scripts
  [镜像仓库地址]/powercli-aws-solidfire:latest \
  pwsh -File /scripts/your_script.ps1  # 执行挂载的脚本

环境变量配置

通过环境变量传递敏感信息（如认证凭证），避免硬编码脚本。支持的环境变量如下：

Docker Compose 示例

通过 docker-compose.yml 定义服务，集成环境变量与目录挂载，便于长期运行或多实例管理：

yaml
version: '3.8'
services:
  powercli-manager:
    image: [镜像仓库地址]/powercli-aws-solidfire:latest
    volumes:
      - ./scripts:/scripts  # 挂载本地脚本目录至容器
    environment:
      - AWS_ACCESS_KEY_ID=AKIAXXXXXXXXXXXXXX
      - AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - AWS_REGION=ap-southeast-1
      - SOLIDFIRE_ENDPOINT=192.168.1.100
      - SOLIDFIRE_USERNAME=admin
      - SOLIDFIRE_PASSWORD=SolidFire123!
    command: pwsh -File /scripts/main_script.ps1  # 启动时执行主脚本

启动服务：

bash
docker-compose up

注意事项

1. 网络连通性：确保容器可访问目标服务（VMware vCenter、AWS API 端点、SolidFire 集群），必要时配置 Docker 网络（如 --network=host 或自定义桥接网络）。
2. 敏感信息保护：环境变量中的密钥、密码等信息建议通过 Docker Secrets 或外部密钥管理工具（如 HashiCorp Vault）注入，避免明文暴露。
3. 模块版本兼容性：镜像内置模块版本可能随 PowerCLI、AWS.netcore、Solidfire.core 的官方更新变化，生产环境建议指定镜像标签（如 v1.0.0）而非 latest，确保版本稳定。
4. 资源限制：运行复杂脚本时，可通过 --memory 和 --cpus 参数限制容器资源占用（如 docker run --memory=2g --cpus=1 ...）。