Azure Kubernetes Service にActions Runner Controller を導入しSelf-hosted runner 環境を構築する

# 変数を定義する
RESOURCE_GROUP_NAME="rg-arctest"
NETWORK_SECURITY_GROUP_NAME="nsg-arctest"
VIRTUAL_NETWORK_NAME="vnet-arctest"
VM_SUBNET_NAME="snet-vm"
AKS_SUBNET_NAME="snet-aks"
VM_PUBLIC_IP_ADDRESS_NAME="pip-vm"
NAT_PUBLIC_IP_ADDRESS_NAME="pip-nat"
NETWORK_INTERFACE_NAME="nic-arctest"
VIRTUAL_MACHINE_NAME="vm-arctest"
OS_DISK_NAME="osdisk-arctest"
ADMIN_USER_NAME="azureuser"
ADMIN_USER_PASSWORD="zRd7-v=sUM5p"
NAT_GATEWAY_NAME="nat-arctest"
AKS_CLUSTER_NAME="aks-arctest"
LOCATION="japaneast"

# リソースグループを作成する
az group create --name $RESOURCE_GROUP_NAME --location $LOCATION

#cloud-config
package_update: true
package_upgrade: true
packages:
  - curl
  - apt-transport-https
  - snapd

runcmd:
  - curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash
  - snap install kubectl --classic
  - curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
  - chmod 700 get_helm.sh
  - ./get_helm.sh

# ネットワークセキュリティグループを作成する
az network nsg create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $NETWORK_SECURITY_GROUP_NAME

# SSH接続用の受信ルールを作成する
az network nsg rule create \
    --resource-group $RESOURCE_GROUP_NAME \
    --nsg-name $NETWORK_SECURITY_GROUP_NAME \
    --name AllowSSHAccess \
    --priority 100 \
    --direction Inbound \
    --access Allow \
    --protocol '*' \
    --source-address-prefixes '<個人のIPアドレス>' \
    --destination-address-prefixes '*' \
    --destination-port-ranges 22

# 仮想ネットワークを作成する
# ここでは仮想マシン用のサブネットを作成する
az network vnet create \
    --name $VIRTUAL_NETWORK_NAME \
    --resource-group $RESOURCE_GROUP_NAME \
    --address-prefix 10.0.0.0/16 \
    --subnet-name $VM_SUBNET_NAME \
    --subnet-prefix 10.0.0.0/24 \
    --network-security-group $NETWORK_SECURITY_GROUP_NAME

# AKS用サブネットを作成する
az network vnet subnet create \
    --resource-group $RESOURCE_GROUP_NAME \
    --vnet-name $VIRTUAL_NETWORK_NAME \
    --name $AKS_SUBNET_NAME \
    --address-prefix 10.0.10.0/24

# パブリックIPアドレス、ネットワークインターフェースを作成する
# パブリックIPアドレスはVM、NATと2つ作成する
az network public-ip create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $VM_PUBLIC_IP_ADDRESS_NAME \
    --sku Standard \
    --allocation-method Static

az network public-ip create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $NAT_PUBLIC_IP_ADDRESS_NAME \
    --sku Standard \
    --allocation-method Static

az network nic create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $NETWORK_INTERFACE_NAME \
    --vnet-name $VIRTUAL_NETWORK_NAME \
    --subnet $VM_SUBNET_NAME \
    --public-ip-address $VM_PUBLIC_IP_ADDRESS_NAME

# 仮想マシンを作成する
# cloud-init経由でAzure CLI、kubectl、Helmをインストールする
# 検証用のため認証をパスワードとする
az vm create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $VIRTUAL_MACHINE_NAME \
    --image Canonical:ubuntu-24_04-lts:server:latest \
    --admin-username $ADMIN_USER_NAME \
    --admin-password $ADMIN_USER_PASSWORD \
    --size Standard_D2s_v3 \
    --os-disk-name $OS_DISK_NAME \
    --nics $NETWORK_INTERFACE_NAME \
    --custom-data cloud-init.txt

# AKSからGitHubへ接続するためのNAT Gatewayを作成しAKSサブネットに関連付けをする
az network nat gateway create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $NAT_GATEWAY_NAME \
    --public-ip-addresses $NAT_PUBLIC_IP_ADDRESS_NAME

az network vnet subnet update \
    --resource-group $RESOURCE_GROUP_NAME \
    --vnet-name $VIRTUAL_NETWORK_NAME \
    --name $AKS_SUBNET_NAME \
    --nat-gateway $NAT_GATEWAY_NAME

# AKS用のサブネットIDを取得
AKS_SUBNET_ID=$(az network vnet subnet show \
    --resource-group $RESOURCE_GROUP_NAME \
    --vnet-name $VIRTUAL_NETWORK_NAME \
    --name $AKS_SUBNET_NAME --query id --output tsv)

# AKSプライベートクラスターを作成する
az aks create \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $AKS_CLUSTER_NAME \
    --load-balancer-sku standard \
    --enable-private-cluster \
    --network-plugin azure \
    --vnet-subnet-id "$AKS_SUBNET_ID" \
    --dns-service-ip 10.2.0.10 \
    --service-cidr 10.2.0.0/24 \
    --generate-ssh-keys

# 接続用Azure VMにログインする
ssh azureuser@<Azure VMのパブリックIPアドレス>

# Azureにログインする
az login

# AKSクラスターに接続する
az aks get-credentials \
    --resource-group $RESOURCE_GROUP_NAME \
    --name $AKS_CLUSTER_NAME

# ARCをインストールする
NAMESPACE="arc-systems"
helm install arc \
    --namespace "${NAMESPACE}" \
    --create-namespace \
    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set-controller

# スケールセットをインストールする
INSTALLATION_NAME="arc-runner-set"
NAMESPACE="arc-runners"
GITHUB_CONFIG_URL="https://github.com/<アカウント名 or 組織名>/<リポジトリ名>"
GITHUB_PAT="<PATの値>"
helm install "${INSTALLATION_NAME}" \
    --namespace "${NAMESPACE}" \
    --create-namespace \
    --set githubConfigUrl="${GITHUB_CONFIG_URL}" \
    --set githubConfigSecret.github_token="${GITHUB_PAT}" \
    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set

.
└ .github/workflows
    └ main.yaml

name: Actions Runner Controller Demo
on:
  push:

jobs:
  Explore-GitHub-Actions:
    # You need to use the INSTALLATION_NAME from the previous step
    runs-on: arc-runner-set
    steps:
    - run: echo "🎉 This job uses runner scale set runners!"

# Runnerの状態を監視する
# 確認後はCtrl+Cで終了する
kubectl get pods -n arc-runners -w

azureuser@vm-arctest:~$ kubectl get pods -n arc-runners -w
NAME                                READY   STATUS    RESTARTS   AGE
arc-runner-set-8xvb9-runner-86lnq   0/1     Pending   0          0s
arc-runner-set-8xvb9-runner-86lnq   0/1     Pending   0          0s
arc-runner-set-8xvb9-runner-86lnq   0/1     ContainerCreating   0          0s
arc-runner-set-8xvb9-runner-86lnq   1/1     Running             0          21s
arc-runner-set-8xvb9-runner-86lnq   0/1     Completed           0          42s
arc-runner-set-8xvb9-runner-86lnq   0/1     Terminating         0          42s
arc-runner-set-8xvb9-runner-dqhh2   0/1     Pending             0          0s
arc-runner-set-8xvb9-runner-dqhh2   0/1     Pending             0          0s
arc-runner-set-8xvb9-runner-dqhh2   0/1     ContainerCreating   0          0s
arc-runner-set-8xvb9-runner-86lnq   0/1     Terminating         0          43s
arc-runner-set-8xvb9-runner-86lnq   0/1     Terminating         0          44s
arc-runner-set-8xvb9-runner-86lnq   0/1     Terminating         0          44s

# リソースをクリーンアップする
az group delete --name rg-arctest