クイックスタート: Azure PowerShell を使用して AKS クラスター用の Azure Linux コンテナーホストをデプロイする

[アーティクル]
09/27/2024

Azure PowerShell を使用して AKS クラスター用の Azure Linux コンテナーホストをデプロイすることで、Azure Linux コンテナーホストの使用を開始します。前提条件をインストールしたら、リソースグループを作成し、AKS クラスターを作成し、クラスターに接続して、クラスターでサンプルのマルチコンテナーアプリケーションを実行します。

前提条件

Azure サブスクリプションをお持ちでない場合は、開始する前に Azure 無料アカウントを作成してください。
Azure Cloud Shell で PowerShell 環境を使用します。詳細については、「Azure Cloud Shell のクイックスタート」を参照してください。
PowerShell をローカルで実行している場合は、Az PowerShell モジュールをインストールし、次に Connect-AzAccount コマンドレットを使用して Azure アカウントに接続します。 Az PowerShell モジュールのインストールの詳細については、「Azure PowerShell のインストール」を参照してください。
クラスターの作成に使用する ID には、適切な最小限のアクセス許可が与えられています。 AKS のアクセスと ID の詳細については、「Azure Kubernetes Service (AKS) でのアクセスと ID オプション」を参照してください。

リソースグループを作成する

Azure リソースグループは、Azure リソースが展開され管理される論理グループです。リソースグループを作成する際は、場所を指定する必要があります。この場所は、リソースグループのメタデータが格納される場所です。また、リソースの作成時に別のリージョンを指定しない場合は、Azure でリソースが実行される場所でもあります。

次の例では、testAzureLinuxResourceGroup という名前のリソースグループを米国東部リージョンに作成します。

New-AzResourceGroup コマンドレットを使用してリソースグループを作成します。
```
New-AzResourceGroup -Name testAzureLinuxResourceGroup -Location eastus
```
リソースグループが正常に作成された場合の出力例は、次のようになります。
```
ResourceGroupName : testAzureLinuxResourceGroup
Location          : eastus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testAzureLinuxResourceGroup
```
Note

上の例では eastus を使用していますが、Azure Linux コンテナーホストクラスターはすべてのリージョンで使用できます。

Azure Linux コンテナーホストクラスターを作成する。

次の例では、1 つのノードを持つ testAzureLinuxCluster という名前のクラスターを作成します。

-NodeOsSKU フラグを AzureLinux に設定した New-AzAksCluster コマンドレットを使用して、AKS クラスターを作成します。
```
New-AzAksCluster -ResourceGroupName testAzureLinuxResourceGroup -Name testAzureLinuxCluster -NodeOsSKU AzureLinux
```
数分後、コマンドが完了し、クラスターに関する情報が JSON 形式で返されます。

クラスターに接続する

Kubernetes クラスターを管理するには、Kubernetes のコマンドラインクライアントである kubectl を使います。 Azure Cloud Shell を使用している場合、kubectl は既にインストールされています。

Install-AzAksCliTool コマンドレットを使用して kubectl をローカルにインストールします。
```
Install-AzAksCliTool
```
Import-AzAksCredential コマンドレットを使用して、Kubernetes クラスターに接続するように kubectl を構成します。このコマンドは、資格情報をダウンロードし、それを使用するように Kubernetes CLI を構成します。
```
Import-AzAksCredential -ResourceGroupName testAzureLinuxResourceGroup -Name testAzureLinuxCluster
```
kubectl get コマンドを使用して、ご利用のクラスターへの接続を確認します。このコマンドを実行すると、クラスターポッドの一覧が返されます。
```
kubectl get pods --all-namespaces
```

アプリケーションの配置

アプリケーションをデプロイするには、マニフェストファイルを使用して、AKS ストアアプリケーションの実行に必要なすべてのオブジェクトを作成します。 Kubernetes のマニフェストファイルでは、どのコンテナーイメージを実行するかなど、クラスターの望ましい状態を定義します。マニフェストには、次の Kubernetes のデプロイとサービスが含まれています。

ネットショップ: 顧客が製品を見て注文するための Web アプリケーション。
製品サービス: 製品情報が表示されます。
注文サービス: 注文を行います。
Rabbit MQ: 注文キューのメッセージキュー。

Note

運用環境の永続ストレージを使用せずに Rabbit MQ などのステートフルコンテナーを実行することはお勧めしません。これらはわかりやすくするためにここで使用しますが、Azure CosmosDB や Azure Service Bus などのマネージドサービスを使用することをお勧めします。

aks-store-quickstart.yaml という名前のファイルを作成し、そこに次のマニフェストをコピーします。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: rabbitmq
spec:
  replicas: 1
  selector:
    matchLabels:
      app: rabbitmq
  template:
    metadata:
      labels:
        app: rabbitmq
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
      - name: rabbitmq
        image: mcr.microsoft.com/mirror/docker/library/rabbitmq:3.10-management-alpine
        ports:
        - containerPort: 5672
          name: rabbitmq-amqp
        - containerPort: 15672
          name: rabbitmq-http
        env:
        - name: RABBITMQ_DEFAULT_USER
          value: "username"
        - name: RABBITMQ_DEFAULT_PASS
          value: "password"
        resources:
          requests:
            cpu: 10m
            memory: 128Mi
          limits:
            cpu: 250m
            memory: 256Mi
        volumeMounts:
        - name: rabbitmq-enabled-plugins
          mountPath: /etc/rabbitmq/enabled_plugins
          subPath: enabled_plugins
      volumes:
      - name: rabbitmq-enabled-plugins
        configMap:
          name: rabbitmq-enabled-plugins
          items:
          - key: rabbitmq_enabled_plugins
            path: enabled_plugins
---
apiVersion: v1
data:
  rabbitmq_enabled_plugins: |
    [rabbitmq_management,rabbitmq_prometheus,rabbitmq_amqp1_0].
kind: ConfigMap
metadata:
  name: rabbitmq-enabled-plugins
---
apiVersion: v1
kind: Service
metadata:
  name: rabbitmq
spec:
  selector:
    app: rabbitmq
  ports:
    - name: rabbitmq-amqp
      port: 5672
      targetPort: 5672
    - name: rabbitmq-http
      port: 15672
      targetPort: 15672
  type: ClusterIP
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: order-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: order-service
  template:
    metadata:
      labels:
        app: order-service
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
      - name: order-service
        image: ghcr.io/azure-samples/aks-store-demo/order-service:latest
        ports:
        - containerPort: 3000
        env:
        - name: ORDER_QUEUE_HOSTNAME
          value: "rabbitmq"
        - name: ORDER_QUEUE_PORT
          value: "5672"
        - name: ORDER_QUEUE_USERNAME
          value: "username"
        - name: ORDER_QUEUE_PASSWORD
          value: "password"
        - name: ORDER_QUEUE_NAME
          value: "orders"
        - name: FASTIFY_ADDRESS
          value: "0.0.0.0"
        resources:
          requests:
            cpu: 1m
            memory: 50Mi
          limits:
            cpu: 75m
            memory: 128Mi
      initContainers:
      - name: wait-for-rabbitmq
        image: busybox
        command: ['sh', '-c', 'until nc -zv rabbitmq 5672; do echo waiting for rabbitmq; sleep 2; done;']
        resources:
          requests:
            cpu: 1m
            memory: 50Mi
          limits:
            cpu: 75m
            memory: 128Mi
---
apiVersion: v1
kind: Service
metadata:
  name: order-service
spec:
  type: ClusterIP
  ports:
  - name: http
    port: 3000
    targetPort: 3000
  selector:
    app: order-service
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: product-service
spec:
  replicas: 1
  selector:
    matchLabels:
      app: product-service
  template:
    metadata:
      labels:
        app: product-service
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
      - name: product-service
        image: ghcr.io/azure-samples/aks-store-demo/product-service:latest
        ports:
        - containerPort: 3002
        resources:
          requests:
            cpu: 1m
            memory: 1Mi
          limits:
            cpu: 1m
            memory: 7Mi
---
apiVersion: v1
kind: Service
metadata:
  name: product-service
spec:
  type: ClusterIP
  ports:
  - name: http
    port: 3002
    targetPort: 3002
  selector:
    app: product-service
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: store-front
spec:
  replicas: 1
  selector:
    matchLabels:
      app: store-front
  template:
    metadata:
      labels:
        app: store-front
    spec:
      nodeSelector:
        "kubernetes.io/os": linux
      containers:
      - name: store-front
        image: ghcr.io/azure-samples/aks-store-demo/store-front:latest
        ports:
        - containerPort: 8080
          name: store-front
        env:
        - name: VUE_APP_ORDER_SERVICE_URL
          value: "http://order-service:3000/"
        - name: VUE_APP_PRODUCT_SERVICE_URL
          value: "http://product-service:3002/"
        resources:
          requests:
            cpu: 1m
            memory: 200Mi
          limits:
            cpu: 1000m
            memory: 512Mi
---
apiVersion: v1
kind: Service
metadata:
  name: store-front
spec:
  ports:
  - port: 80
    targetPort: 8080
  selector:
    app: store-front
  type: LoadBalancer

YAML ファイルをローカルに作成して保存する場合は、[ファイルのアップロード/ダウンロード] ボタンを選択し、ローカルファイルシステムからファイルを選択することで、CloudShell の既定のディレクトリにマニフェストファイルをアップロードできます。

kubectl apply コマンドを使用してアプリケーションをデプロイし、ご利用の YAML マニフェストの名前を指定します。

kubectl apply -f aks-store-quickstart.yaml

次の出力例は、デプロイとサービスを示しています。

deployment.apps/rabbitmq created
service/rabbitmq created
deployment.apps/order-service created
service/order-service created
deployment.apps/product-service created
service/product-service created
deployment.apps/store-front created
service/store-front created

アプリケーションをテストする

アプリケーションが実行されると、Kubernetes サービスによってアプリケーションフロントエンドがインターネットに公開されます。このプロセスが完了するまでに数分かかることがあります。

kubectl get pods コマンドを使って、デプロイされたポッドの状態を確認します。続行する前に、すべてのポッドを Running の状態にします。
```
kubectl get pods
```
ストアフロントアプリケーションのパブリック IP アドレスを確認します。 kubectl get service コマンドと --watch 引数を使用して、進行状況を監視します。
```
kubectl get service store-front --watch
```
store-front サービスの [EXTERNAL-IP] の出力は、最初は pending と表示されます。
```
NAME          TYPE           CLUSTER-IP    EXTERNAL-IP   PORT(S)        AGE
store-front   LoadBalancer   10.0.100.10   <pending>     80:30025/TCP   4h4m
```
EXTERNAL-IP アドレスが保留中から実際のパブリック IP アドレスに変わったら、CTRL-C を使用して kubectl ウォッチプロセスを停止します。

次の出力例は、サービスに割り当てられている有効なパブリック IP アドレスを示しています。
```
NAME          TYPE           CLUSTER-IP    EXTERNAL-IP    PORT(S)        AGE
store-front   LoadBalancer   10.0.100.10   20.62.159.19   80:30025/TCP   4h5m
```
Azure Store アプリが動作していることを確認するには、Web ブラウザーを開いてサービスの外部 IP アドレスにアクセスします。

クラスターを削除する

次のチュートリアルを続行する予定がない場合は、Azure の料金が発生しないように作成したリソースを削除します。

RemoveAzResourceGroup コマンドレットを使って、リソースグループと関連するリソースをすべて削除します。
```
Remove-AzResourceGroup -Name testAzureLinuxResourceGroup
```

次のステップ

このクイックスタートでは、Azure Linux コンテナーホスト AKS クラスターをデプロイしました。 Azure Linux コンテナーホストの詳細を確認し、完全なクラスターのデプロイと管理の例を確認するには、続けて Azure Linux コンテナーホストのチュートリアルに進んでください。

Azure Linux コンテナーホストのチュートリアル

次の方法で共有

クイックスタート: Azure PowerShell を使用して AKS クラスター用の Azure Linux コンテナーホストをデプロイする

前提条件

リソースグループを作成する

Azure Linux コンテナーホストクラスターを作成する。

クラスターに接続する

アプリケーションの配置

アプリケーションをテストする

クラスターを削除する

次のステップ

フィードバック

その他のリソース

次の方法で共有

クイックスタート: Azure PowerShell を使用して AKS クラスター用の Azure Linux コンテナー ホストをデプロイする

前提条件

リソース グループを作成する

Azure Linux コンテナー ホスト クラスターを作成する。

クラスターに接続する

アプリケーションの配置

アプリケーションをテストする

クラスターを削除する

次のステップ

フィードバック

その他のリソース

クイックスタート: Azure PowerShell を使用して AKS クラスター用の Azure Linux コンテナーホストをデプロイする

リソースグループを作成する

Azure Linux コンテナーホストクラスターを作成する。