(非推奨) Linux コンテナー用の Kubernetes クラスターをデプロイする

[アーティクル]
02/26/2018

ヒント

Azure Kubernetes Service を使用するこのクイックスタートの更新バージョンについては、「 Quickstart: Azure Kubernetes Service (AKS) クラスターをデプロイする」を参照してください。

警告

Azure Container Service (ACS) は非推奨となっています。 ACS に新しい機能が追加されることはありません。 API、ポータルのエクスペリエンス、CLI コマンド、ドキュメントはすべて非推奨としてマークされます。

Azure Kubernetes Service (AKS) は、Kubernetes の管理、デプロイ、および運用を簡素化するために 2017 年に導入されました。 Kubernetes オーケストレーターを使用する場合は、2020 年 1 月 31 日までに AKS に移行してください。まずは、Azure Kubernetes Service への移行に関するページを参照してください。

詳細については、Azure.com で Azure Container Service の非推奨化に関するお知らせを参照してください。

このクイックスタートでは、Azure CLI を使用して Kubernetes クラスターをデプロイします。次に、Web フロントエンドと Redis インスタンスで構成される複数コンテナーアプリケーションをデプロイして、このクラスターで実行します。完了すると、このアプリケーションはインターネット経由でアクセス可能になります。

このドキュメントで使用されているサンプルアプリケーションは、Python で作成されています。ここで詳しく説明している概念と手順は、あらゆるコンテナーイメージを Kubernetes クラスターにデプロイする目的で使用できます。このプロジェクトに関連してあらかじめ作成された Kubernetes マニフェストファイルとコード、Dockerfile は、GitHub で入手できます。

Azure Vote にブラウザーでアクセスしたところ

このクイックスタートは、Kubernetes の概念についての基礎知識があることを前提としています。Kubernetes について詳しくは、Kubernetes のドキュメントをご覧ください。

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンドブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニューバーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

Cloud Shell を開始します。
コードブロック (またはコマンドブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。

CLI をローカルにインストールして使用する場合、このクイックスタートを実施するには、Azure CLI バージョン 2.0.4 以降を実行している必要があります。バージョンを確認するには、az --version を実行します。インストールまたはアップグレードが必要な場合は、Azure CLI のインストールに関するページを参照してください。

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

az group create コマンドを使用して、リソースグループを作成します。 Azure リソースグループは、Azure リソースが展開され管理される論理グループです。

次の例では、myResourceGroup という名前のリソースグループを westeurope の場所に作成します。

az group create --name myResourceGroup --location westeurope

出力:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup",
  "location": "westeurope",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

Kubernetes クラスターを作成する

az acs create コマンドを使用して Azure Container Service に Kubernetes クラスターを作成します。次の例では、1 つの Linux マスターノードと 3 つの Linux エージェントノードを含む、myK8sCluster という名前のクラスターを作成します。

az acs create --orchestrator-type kubernetes --resource-group myResourceGroup --name myK8sCluster --generate-ssh-keys

制限付き試用版を使用する場合など、Azure サブスクリプションによって Azure リソースへのアクセスが制限される場合もあります。使用可能なコア数が限られているためにデプロイが失敗した場合は、--agent-count 1 を az acs create コマンドに追加して、既定のエージェント数を減らします。

数分してコマンドが完了すると、このクラスターに関する情報が json 形式で表示されます。

クラスターに接続する

Kubernetes クラスターを管理するには、Kubernetes のコマンドラインクライアントである kubectl を使用します。

Azure Cloud Shell を使用している場合、kubectl は既にインストールされています。ローカルにインストールする場合には、az acs kubernetes install-cli コマンドを使用します。

Kubernetes クラスターに接続するように kubectl を構成するには、az acs kubernetes get-credentials コマンドを実行します。この手順では、資格情報をダウンロードし、Kubernetes CLI を構成してそれらの資格情報を使用します。

az acs kubernetes get-credentials --resource-group=myResourceGroup --name=myK8sCluster

クラスターへの接続を確認するには、クラスターノードの一覧を返す kubectl get コマンドを使用します。

kubectl get nodes

出力:

NAME                    STATUS                     AGE       VERSION
k8s-agent-14ad53a1-0    Ready                      10m       v1.6.6
k8s-agent-14ad53a1-1    Ready                      10m       v1.6.6
k8s-agent-14ad53a1-2    Ready                      10m       v1.6.6
k8s-master-14ad53a1-0   Ready,SchedulingDisabled   10m       v1.6.6

アプリケーションの実行

Kubernetes のマニフェストファイルでは、どのようなコンテナーイメージを実行するかというようなことも含め、クラスターの望ましい状態を定義します。この例では、マニフェストを使用して、Azure Vote アプリケーションを実行するために必要なすべてのオブジェクトを作成します。

azure-vote.yml という名前のファイルを作成し、そこに以下の YAML をコピーします。 Azure Cloud Shell で作業している場合、仮想システムまたは物理システムで作業するときと同じように vi または Nano を使用してこのファイルを作成できます。

apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: azure-vote-back
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: azure-vote-back
    spec:
      containers:
      - name: azure-vote-back
        image: redis
        ports:
        - containerPort: 6379
          name: redis
---
apiVersion: v1
kind: Service
metadata:
  name: azure-vote-back
spec:
  ports:
  - port: 6379
  selector:
    app: azure-vote-back
---
apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: azure-vote-front
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: azure-vote-front
    spec:
      containers:
      - name: azure-vote-front
        image: microsoft/azure-vote-front:v1
        ports:
        - containerPort: 80
        env:
        - name: REDIS
          value: "azure-vote-back"
---
apiVersion: v1
kind: Service
metadata:
  name: azure-vote-front
spec:
  type: LoadBalancer
  ports:
  - port: 80
  selector:
    app: azure-vote-front

kubectl create コマンドを使ってアプリケーションを実行します。

kubectl create -f azure-vote.yml

出力:

deployment "azure-vote-back" created
service "azure-vote-back" created
deployment "azure-vote-front" created
service "azure-vote-front" created

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

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

進行状況を監視するには、kubectl get service コマンドを --watch 引数と一緒に使用します。

kubectl get service azure-vote-front --watch

最初に、azure-vote-front サービスの EXTERNAL-IP が "保留中" として表示されます。 EXTERNAL-IP アドレスが "保留中" から "IP アドレス" に変わると、CTRL-C を使用してkubectl ウォッチプロセスを停止します。

azure-vote-front   10.0.34.242   <pending>     80:30676/TCP   7s
azure-vote-front   10.0.34.242   52.179.23.131   80:30676/TCP   2m

これで、外部 IP アドレスを参照して Azure Vote アプリを表示できるようになりました。

Azure Vote にブラウザーでアクセスしたところ

クラスターを削除する

クラスターが必要なくなったら、az group delete コマンドを使って、リソースグループ、コンテナーサービス、およびすべての関連リソースを削除できます。

az group delete --name myResourceGroup --yes --no-wait

コードを取得する

このクイックスタートでは、事前に作成したコンテナーイメージを使用して、Kubernetes のデプロイを作成しました。関連するアプリケーションコード、Dockerfile、Kubernetes マニフェストファイルは、GitHub で入手できます。

https://github.com/Azure-Samples/azure-voting-app-redis

次のステップ

このクイックスタートでは、Kubernetes クラスターをデプロイし、そこに複数コンテナーアプリケーションをデプロイしました。

Azure Container Service の詳細を参照し、デプロイの例の完全なコードを確認するには、Kubernetes クラスターチュートリアルに進んでください。

ACS Kubernetes クラスターの管理

次の方法で共有

(非推奨) Linux コンテナー用の Kubernetes クラスターをデプロイする

Azure Cloud Shell

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

Kubernetes クラスターを作成する

クラスターに接続する

アプリケーションの実行

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

クラスターを削除する

コードを取得する

次のステップ

その他のリソース

次の方法で共有

(非推奨) Linux コンテナー用の Kubernetes クラスターをデプロイする

Azure Cloud Shell

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

Kubernetes クラスターを作成する

クラスターに接続する

アプリケーションの実行

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

クラスターを削除する

コードを取得する

次のステップ

その他のリソース

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