Container Service for Kubernetes:ALB Ingress による Service の公開

クラスター作成時

1. ACK コンソールにログインし、[Kubernetes クラスターの作成] をクリックします。

2. [コンポーネント設定] ステップで、[Ingress] セクションを見つけ、[ALB Ingress] を選択します。

3. 新しい ALB インスタンスを作成するオプションを選択し、画面の指示に従ってクラスターを作成します。

   ALB インスタンス		説明
   新規		ALB インスタンス、AlbConfig、および IngressClass を自動的に作成します。 ALB インスタンス: 従量課金制の標準 ALB インスタンス (パブリックまたはプライベート) がクラスターの Virtual Private Cloud (VPC) 内に作成され、ポート 80 (HTTP) にデフォルトのリスナーが設定されます。 AlbConfig と IngressClass: 対応する AlbConfig および IngressClass リソースがクラスター内に自動的に作成され、新しい ALB インスタンスに関連付けられます。
   既存 このオプションは、クラスターネットワークに既存の VPC を選択した場合にのみ使用できます。		既存の ALB インスタンスを使用し、関連する AlbConfig と IngressClass を自動的に作成します。選択した ALB インスタンスは、次の基準を満たす必要があります: エディション: 標準または WAF-enabled である。 ネットワーク: クラスターと同じ VPC 内にある。 関連付け: 他のクラスターに既に関連付けられていない。
   今は作成しない		ALB Ingress Controller コンポーネントのみをインストールします。後で AlbConfig および IngressClass リソースを手動で作成する必要があります。このオプションは、ALB インスタンスの設定をカスタマイズする必要があるシナリオに適しています。

既存のクラスターの場合

1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、管理するクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、[アドオン] をクリックします。

3. [アドオン] ページで、[ネットワーク] タブをクリックします。[ALB Ingress Controller] を見つけて、[インストール] をクリックします。

4. 新しい ALB インスタンスを作成するオプションを選択し、[OK] をクリックします。

   ALB インスタンス		説明
   新規		ALB インスタンス、AlbConfig、および IngressClass を自動的に作成します。 ALB インスタンス: 従量課金制の標準 ALB インスタンス (パブリックまたはプライベート) がクラスターの Virtual Private Cloud (VPC) 内に作成され、ポート 80 (HTTP) にデフォルトのリスナーが設定されます。 AlbConfig と IngressClass: 対応する AlbConfig および IngressClass リソースがクラスター内に自動的に作成され、新しい ALB インスタンスに関連付けられます。
   既存		既存の ALB インスタンスを使用し、関連する AlbConfig と IngressClass を自動的に作成します。選択した ALB インスタンスは、次の基準を満たす必要があります: エディション: 標準または WAF-enabled である。 ネットワーク: クラスターと同じ VPC 内にある。 関連付け: 他のクラスターに既に関連付けられていない。
   今は作成しない		ALB Ingress Controller コンポーネントのみをインストールします。後で AlbConfig および IngressClass リソースを手動で作成する必要があります。このオプションは、ALB インスタンスの構成をカスタマイズする必要があるシナリオに適しています。

コンソール

1. [クラスター] ページで、管理したいクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、[ワークロード] > [Deployment] を選択します。

2. [YAML から作成] をクリックします。[サンプルテンプレート] を [カスタム] に設定し、次の内容をテンプレートエディターにコピーして、[デプロイ] をクリックします。

   YAML テンプレート

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: coffee
     namespace: default
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: coffee
     template:
       metadata:
         labels:
           app: coffee
       spec:
         containers:
         - name: coffee
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
           ports:
           - containerPort: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: coffee-svc
     namespace: default
   spec:
     ports:
     - port: 80
       targetPort: 80
       protocol: TCP
     selector:
       app: coffee
     type: ClusterIP

3. 表示されるダイアログボックスで、[表示] をクリックし、Pod のステータスが Running であることを確認します。

kubectl

1. クラスターの kubeconfig を取得し、kubectl を使用してクラスターに接続します。

2. coffee-deployment-service.yaml という名前のファイルを次の内容で作成します:

   YAML テンプレート

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: coffee
     namespace: default
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: coffee
     template:
       metadata:
         labels:
           app: coffee
       spec:
         containers:
         - name: coffee
           image: registry.cn-hangzhou.aliyuncs.com/acs-sample/nginxdemos:latest
           ports:
           - containerPort: 80
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: coffee-svc
     namespace: default
   spec:
     ports:
     - port: 80
       targetPort: 80
       protocol: TCP
     selector:
       app: coffee
     type: ClusterIP

3. アプリケーションをデプロイします。

   kubectl apply -f coffee-deployment-service.yaml

4. Pod が実行中であることを確認します。

    kubectl get pod -l app=coffee

   期待される出力:

   NAME                      READY   STATUS    RESTARTS   AGE
   coffee-84bd6*****-*****   1/1     Running   0          4m22s
   coffee-84bd6*****-*****   1/1     Running   0          4m22s

コンソール

1. 左側のナビゲーションウィンドウで、[ネットワーク] > [Ingresse] を選択します。default 名前空間を選択し、[Ingress の作成] をクリックします。

2. 以下のように設定し、[OK] をクリックします。

   • 名前: coffee-ingress

   • ドメイン名: ingress-demo.com

   • マッピング

     • パス: /coffee

     • ルール: Prefix

     • サービス: coffee-svc

     • ポート: 80

       マッチングルール(pathType)	説明
       Prefix	URL パスのプレフィックスに基づいてマッチングします。例えば、パスが /coffee のルールは、/coffee/1 や /coffee/buy/1 のリクエストにマッチしますが、/cof や /coffeebuy/1 にはマッチしません。
       Exact	URL パスに完全に一致します。パスが /coffee のルールの場合、/coffee というパスへのリクエストのみがマッチします。
       ImplementationSpecific	マッチング動作は Ingress コントローラーに依存します。ALB Ingress controller の場合、このタイプは Exact マッチと同等です。

3. [エンドポイント] を取得します。

   ALB Ingress が有効になるまで約 10 秒かかります。更新ボタンをクリックしてエンドポイント情報を取得します。長時間経ってもエンドポイント情報が更新されない場合は、Ingress 名をクリックして [イベント] タブに移動し、トラブルシューティングを行ってください。

   

4. ドメイン名とエンドポイントをテストします。HTTP ステータスコードが 200 の場合、ALB Ingress は作成されています。

   curl -H "Host:ingress-demo.com" http://<Endpoint address>/coffee -s -o /dev/null -w "%{http_code}\n"

kubectl

1. coffee-ingress.yaml というファイルを作成します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: coffee-ingress
     namespace: default
   spec:
     ingressClassName: alb
     rules:
     - host: ingress-demo.com
       http:
         paths:
         - path: /coffee
           backend:
             service: 
               name: coffee-svc
               port:
                 number: 80
           pathType: Prefix

   一致ルール (pathType)	説明
   Prefix	URL パスのプレフィックスに基づいてマッチングします。例えば、パスが /coffee のルールは、/coffee/1 や /coffee/buy/1 のリクエストにマッチしますが、/cof や /coffeebuy/1 にはマッチしません。
   完全	URL パスに完全に一致します。パスが /coffee のルールの場合、/coffee というパスへのリクエストのみがマッチします。
   ImplementationSpecific	マッチング動作は Ingress コントローラーに依存します。ALB Ingress controller の場合、このタイプは Exact マッチと同等です。

2. Ingress をデプロイします。

   kubectl apply -f coffee-ingress.yaml

3. ADDRESS フィールドから Ingress のパブリックエンドポイントを取得します。アドレスが割り当てられるまで少し時間がかかる場合があります。

   kubectl get ingress coffee-ingress -o jsonpath='{.status.loadBalancer.ingress[0].hostname}'

   期待される出力:

   alb-******************.cn-wulanchabu.alb.aliyuncsslb.com

4. ドメイン名とエンドポイントをテストします。HTTP ステータスコードが 200 の場合、ALB Ingress は作成されています。

   curl -H "Host:ingress-demo.com" http://<Endpoint address>/coffee -s -o /dev/null -w "%{http_code}\n"