joeltimothyoh/powershell

docker-powershell

镜像概述

docker-powershell是一个基于微软官方PowerShell镜像（mcr.microsoft.com/powershell）构建的Docker化环境，集成了常用工具，提供便捷的跨平台PowerShell运行环境。

核心功能和特性

• 官方基础：以微软官方PowerShell镜像为基础，确保与标准PowerShell环境的兼容性和稳定性
• 工具集成：内置实用工具，满足日常PowerShell脚本执行和管理需求
• 轻量级设计：优化镜像结构，减少冗余，便于快速部署和运行
• 跨平台支持：可在Docker支持的各类操作系统（如Linux、Windows、macOS）上运行

使用场景和适用范围

• 自动化脚本执行：无需本地安装PowerShell，直接运行PowerShell自动化脚本
• CI/CD流程集成：在持续集成/持续部署 pipeline 中执行PowerShell任务
• 开发测试环境：快速搭建一致的PowerShell开发、测试环境，避免环境差异问题
• 跨平台脚本验证：在非Windows系统上验证PowerShell脚本的兼容性和执行效果

使用方法和配置说明

基本交互式使用

通过以下命令启动交互式PowerShell会话：

bash
docker run -it --rm docker.xuanyuan.run/joeltimothyoh/powershell

运行本地PowerShell脚本

挂载本地脚本目录并执行指定脚本：

bash
docker run -it --rm -v /path/to/local/scripts:/scripts docker.xuanyuan.run/joeltimothyoh/powershell pwsh /scripts/your-script.ps1

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  powershell:
    image: docker.xuanyuan.run/joeltimothyoh/powershell
    volumes:
      - ./local-scripts:/app/scripts  # 挂载本地脚本目录
      - ./data:/app/data            # 挂载数据目录
    command: pwsh /app/scripts/main.ps1  # 执行指定脚本

启动服务：

bash
docker-compose up

常用配置选项

• 卷挂载：使用-v参数挂载本地目录，实现脚本和数据的持久化与共享
• 命令覆盖：通过docker run命令或docker-compose的command字段指定要执行的PowerShell命令或脚本
• 环境变量：使用-e参数设置环境变量，供PowerShell脚本使用，例如：

  bash
  docker run -it --rm -e "ENVIRONMENT=production" docker.xuanyuan.run/joeltimothyoh/powershell pwsh -c "$env:ENVIRONMENT"