startupjs/deploy-aks

StartupJS AKS部署助手镜像

镜像概述

StartupJS AKS部署助手镜像是一个专为特定配置的Azure Kubernetes Service (AKS)集群设计的CI/CD工具镜像，旨在简化基于StartupJS框架开发的应用在AKS集群中的部署流程。该镜像集成了部署所需的核心工具和配置模板，提供标准化的部署流程，减少手动操作，提升部署效率和一致性。

核心功能

1. 自动化部署流程

• 内置部署脚本，支持从代码构建到集群部署的全流程自动化
• 集成部署前检查机制，验证集群连接性和资源配置

2. AKS集群集成

• 预配置AKS集群访问工具（kubectl、az cli）
• 支持通过服务主体或托管身份进行AKS集群认证
• 自动获取集群上下文并配置kubeconfig

3. CI/CD管道适配

• 兼容主流CI/CD平台（GitHub Actions、GitLab CI、Jenkins等）
• 提供管道配置示例，快速集成到现有CI/CD流程

4. 工具链集成

• 包含helm（Kubernetes包管理）、kubectx（集群上下文切换）等工具
• 内置StartupJS应用部署专用配置模板

使用场景

适用范围

• 基于StartupJS框架开发的前端/全栈应用
• 采用特定网络、安全策略配置的AKS集群环境
• 需要标准化CI/CD部署流程的团队或项目

典型场景

• CI/CD流水线中的自动化部署阶段
• 多环境（开发/测试/生产）AKS集群部署
• 团队协作中的一致化部署操作

使用方法

镜像拉取

bash
docker pull docker.xuanyuan.run/startupjs/deploy-aks:latest

基础部署命令

bash
docker run --rm \
  -v $HOME/.azure:/root/.azure \  # 挂载Azure CLI配置
  -v $(pwd)/deploy-config:/app/config \  # 挂载部署配置文件
  -e AKS_CLUSTER_NAME="my-aks-cluster" \
  -e RESOURCE_GROUP="my-resource-group" \
  -e NAMESPACE="default" \
  startupjs/deploy-aks:latest \
  /app/scripts/deploy.sh

环境变量配置

CI/CD集成示例（GitHub Actions）

yaml
jobs:
  deploy-to-aks:
    runs-on: ubuntu-latest
    steps:
      - name: Pull deployment image
        run: docker pull docker.xuanyuan.run/startupjs/deploy-aks:latest
      
      - name: Deploy to AKS
        run: |
          docker run --rm \
            -e AKS_CLUSTER_NAME="${{ secrets.AKS_CLUSTER_NAME }}" \
            -e RESOURCE_GROUP="${{ secrets.RESOURCE_GROUP }}" \
            -e AZURE_TENANT_ID="${{ secrets.AZURE_TENANT_ID }}" \
            -e AZURE_CLIENT_ID="${{ secrets.AZURE_CLIENT_ID }}" \
            -e AZURE_CLIENT_SECRET="${{ secrets.AZURE_CLIENT_SECRET }}" \
            docker.xuanyuan.run/startupjs/deploy-aks:latest \
            /app/scripts/deploy.sh

注意事项

• 确保AKS集群已启用RBAC，且服务主体/认证账户具有足够权限（至少包含Contributor或AKS Cluster Admin角色）
• 生产环境建议使用托管身份认证而非服务主体密钥
• 部署前需验证本地网络可访问AKS集群API端点（可通过az aks show --name <cluster> --resource-group <rg> --query "fqdn"确认）