Container Compute Service (ACS) では、コンテナイメージ、オーケストレーション YAML テンプレート、または kubectl コマンドラインツールを使用して、ステートレスアプリケーションを作成できます。このトピックでは、Nginx アプリケーションを例として、ACS クラスターでステートレスアプリケーションを作成する方法について説明します。
コンソール
イメージから作成
ステップ 1:アプリケーションの基本情報の設定
-
ACS コンソールにログインします。左側のナビゲーションペインで、クラスターリストをクリックします。
-
クラスターリスト ページで、目的のクラスターの名前をクリックします。左側のナビゲーションペインで、ワークロード > デプロイメント を選択します。
-
デプロイメント ページで、イメージによる作成 をクリックします。
-
基本情報 ウィザードで、アプリケーションの基本設定を行います。
パラメーター
説明
[名前]
アプリケーションの名前を入力します。
[Replicas:]
アプリケーション内の Pod の数です。デフォルト値は 2 です。
[ワークロード]
デプロイ を選択します。
[タグ]
このアプリケーションを識別するための Label を追加します。
[注釈]
アプリケーションに Annotation を追加します。
[インスタンスタイプ]
コンピューティングタイプを選択します。コンピューティングタイプの詳細については、「ACS Pod インスタンスの概要」をご参照ください。
[QoS タイプ]
QoS (Quality of Service) クラスを選択します。
-
次 をクリックして、コンテナー ウィザードに進みます。
ステップ 2:コンテナの設定
コンテナー ウィザードページで、コンテナイメージ、リソース、ポート、環境変数、ヘルスチェック、ライフサイクル、ボリューム、およびログを設定します。
ポッドに複数のコンテナーを追加するには、[コンテナー 1] タブの横にある コンテナを追加 をクリックします。
-
一般 セクションで、コンテナの基本設定を完了します。
パラメーター
説明
[イメージ名]
-
イメージの選択
イメージの選択 をクリックして、必要なイメージを選択します。
-
[Container Registry Enterprise Edition]: Alibaba Cloud Container Registry (ACR) でホストされているエンタープライズ版イメージを選択します。イメージが存在するリージョンと ACR インスタンスを選択する必要があります。ACR の詳細については、「Container Registry とは」をご参照ください。
-
[Container Registry Personal Edition] (最初に有効化する必要があります):ACR でホストされている個人版イメージを選択します。イメージが存在するリージョンと ACR インスタンスを選択する必要があります。
-
[Artifact center]: コンテナ化されたアプリケーション用のベース OS イメージ、言語ランタイムイメージ、および AI/ビッグデータ関連のイメージが含まれます。この例では、アーティファクトセンターの Nginx イメージを使用します。詳細については、「アーティファクトセンター」をご参照ください。
-
-
(オプション) イメージプルポリシーの設定
ImagePullPolicy ドロップダウンリストからプルポリシーを選択します。デフォルトでは、ポリシーは設定されておらず、Kubernetes は IfNotPresent を使用します。
-
[IfNotPresent]: イメージがローカルにすでに存在する場合 (以前にホストにプルされている場合) は、再度プルされることはありません。それ以外の場合、イメージはプルされます。
-
[Always]:デプロイまたはスケールアウト中に、ローカルコピーを無視してイメージをプルします。
-
[Never]: ローカルイメージのみを使用します。
-
-
(オプション) Image Pull Secret の設定
イメージの秘密鍵の設定 をクリックして、プライベートイメージに安全にアクセスします。
-
ACR Personal Edition インスタンスの場合、Image Pull Secret を設定することでコンテナイメージをプルできます。詳細については、「シークレットの管理」をご参照ください。
-
ACR Enterprise Edition インスタンスの場合、パスワードレスアドオンを使用することで、パスワードなしでイメージをプルできます。詳細については、「パスワードなしで ACR イメージをプルする」をご参照ください。
-
[リソースリクエスト]
コンテナのリソースクォータを設定します。
[インタラクティブセッション]
(オプション) コンテナの起動オプションを設定します。
-
stdin:コンソール入力をコンテナに送信します。
-
tty:標準入力コンソールをコンテナのコンソール入力としてアタッチします。
説明通常、stdin と tty の両方を選択して、ターミナル (tty) をコンテナの標準入力 (stdin) にバインドします。たとえば、インタラクティブなプログラムは stdin からユーザー入力を読み取り、ターミナルに出力を表示します。
[コンテナー初期化]
(オプション) このオプションを選択して、Init コンテナを作成します。
Init コンテナは、アプリケーションコンテナの起動が成功するまでブロックまたは遅延させることができます。正常に実行された後、Pod 内のアプリケーションコンテナは並行して起動します。たとえば、Init コンテナを使用して、依存するサービスの可用性を確認できます。Init コンテナには、アプリケーションイメージに存在しないユーティリティやインストールスクリプトを含めることで、カーネルパラメーターの設定や設定ファイルの生成など、ランタイム環境を初期化できます。詳細については、「Init Containers」をご参照ください。
-
-
(オプション) ポート設定 セクションで、Add をクリックしてコンテナポートを設定します。
パラメーター
説明
[名前]
コンテナポートの名前を指定します。
[コンテナーポート]
公開するコンテナのアクセスポートを指定します。ポート番号は 1 から 65535 の範囲でなければなりません。
[プロトコル]
サポートされているプロトコルは TCP と UDP です。
-
(任意) 環境 セクションで、Add をクリックして環境変数を設定します。
キーと値のペアを使用して Pod の環境変数を設定し、環境フラグを追加したり、設定を渡したりできます。詳細については、「Pod の環境変数」をご参照ください。
パラメーター
説明
[タイプ]
環境変数のタイプを設定します:
-
[カスタム]
-
[ConfigMap]
-
[シークレット]
-
[Value/ValueFrom]
-
[ResourceFieldRef]
ConfigMap と Secret は、すべてのファイルの参照に対応しています。
この例では Secret を使用します。シークレット タイプを選択し、対象の Secret を選択すると、その Secret 内のすべてのファイルがデフォルトで参照されます。[シークレット] を選択した後、[変数名] を入力し、右側の 2 つのドロップダウンリストから対応する Secret 名とキーを選択します。
対応する YAML は、次のように Secret 全体を参照します。
envFrom: - secretRef: name: test[変数名]
環境変数の名前を設定します。
[Value/ValueFrom]
参照される変数の値を設定します。
-
-
(オプション) ヘルスチェッ セクションで、必要に応じて 有効性チェック、レディチェック、および 起動 を有効にします。
-
[Liveness プローブ]:Liveness プローブは、コンテナが実行中であるかどうかをチェックします。プローブが複数回失敗した場合、kubelet はコンテナを再起動します。これは、コンテナは実行中だが処理を進めることができないデッドロックなどの問題を解決するのに役立ちます。
-
[Readiness プローブ]:Readiness プローブは、コンテナがトラフィックを受け入れる準備ができているかどうかをチェックします。Pod は、Readiness プローブが成功した後にのみ Service のバックエンドとして追加されます。
-
[Startup プローブ]:これらのプローブは、コンテナが正常に起動したかどうかをチェックするために、コンテナの起動時にのみ実行されます。[Liveness プローブ]と [Readiness プローブ]は、Startup プローブが成功した後にのみ実行されます。
詳細については、「Liveness、Readiness、および Startup プローブの設定」をご参照ください。
パラメーター
説明
[HTTP リクエスト]
コンテナに HTTP GET リクエストを送信します。サポートされているパラメーターは以下の通りです。
-
[プロトコル]:HTTP/HTTPS。
-
[パス]: HTTP サーバーにアクセスするためのパスです。
-
[ポート]: 公開コンテナポートまたはポート名。ポート番号は 1~65535 の範囲で指定します。
-
[HTTP ヘッダ]:HTTP リクエストのカスタムリクエストヘッダーです。HTTP では、ヘッダーの重複が許可されています。キーと値のペアとして設定します。
-
[遅延検出時間(秒)]: initialDelaySeconds パラメーターは、コンテナが起動してから最初のプローブを実行するまでに何秒待機するかを指定します。デフォルトは 3 秒です。
-
[実行検出周期(秒)]: periodSeconds パラメーターで、プローブ間の時間間隔を指定します。デフォルトは 10 秒です。最小値は 1 秒です。
-
[タイムアウト時間(秒)]: timeoutSeconds パラメーターは、プローブのタイムアウト期間を指定します。デフォルトは 1 秒です。最小値は 1 秒です。
-
[正常のしきい値]: 失敗が検出された後、コンテナを正常とマークするために必要な、連続した成功プローブの最小回数です。 デフォルトは 1 です。 最小値は 1 です。 liveness プローブの場合、この値は 1 である必要があります。
-
[異常のしきい値]: コンテナを異常と判断するために必要な、連続したプローブの失敗回数です。デフォルトは 3、最小値は 1 です。
[TCP 接続]
コンテナへの TCP ソケットを開きます。kubelet は指定されたポートでソケットを開こうとします。成功した場合、コンテナは正常と見なされます。それ以外の場合は、失敗と見なされます。サポートされているパラメーターは以下の通りです。
-
[ポート]:公開されるコンテナポートまたはポート名。ポート番号は 1 ~ 65535 の範囲で指定します。
-
[遅延検出時間(秒)]: initialDelaySeconds パラメーターは、コンテナの起動後、最初のプローブを実行するまでに待機する秒数を指定します。デフォルトは 15 秒です。
-
[実行検出周期(秒)]: periodSeconds パラメーターは、プローブ間の時間間隔を指定します。デフォルトは 10 秒です。最小値は 1 秒です。
-
[タイムアウト時間(秒)]: timeoutSeconds パラメーターは、プローブのタイムアウト期間を指定します。デフォルトは 1 秒です。最小値は 1 秒です。
-
[正常のしきい値]: プローブが失敗した後、コンテナが正常であると判断されるために必要な、連続した成功プローブの最小回数です。デフォルト値は 1 です。最小値は 1 です。liveness プローブの場合、この値は 1 である必要があります。
-
[異常のしきい値]: コンテナが異常であると判断されるまでに必要な、連続したプローブ失敗の最小回数です。 デフォルトは 3 です。 最小値は 1 です。
[コマンドライン]
コンテナ内でコマンドを実行して、そのヘルス状態を確認します。サポートされているパラメーターは以下の通りです。
-
[コマンドライン]: コンテナのヘルスをチェックするために使用されるコマンド。
-
[遅延検出時間(秒)]: initialDelaySeconds パラメーターは、コンテナの起動後に最初のプローブを実行するまで待機する秒数を指定します。デフォルトは 5 秒です。
-
[実行検出周期(秒)]: periodSeconds パラメーターは、プローブ間の時間間隔を指定します。デフォルトは 10 秒です。最小値は 1 秒です。
-
[タイムアウト時間(秒)]: timeoutSeconds パラメーターはプローブのタイムアウト期間を指定します。 デフォルトは 1 秒です。 最小は 1 秒です。
-
[正常のしきい値]: 失敗後、コンテナが正常であると判断されるために必要な、連続した成功プローブの最小回数です。デフォルトは 1 です。最小値は 1 です。liveness プローブの場合、この値は 1 である必要があります。
-
[異常のしきい値]:コンテナが正常な状態と判断された後、異常な状態と判断されるまでに必要な、連続したプローブ失敗の最小回数です。デフォルトは 3、最小値は 1 です。
-
-
(任意) ライフサイクル セクションで、コンテナのライフサイクルを設定します。
コンテナのライフサイクルに、開始前コマンド、開始後ハンドラー、および停止前ハンドラーを設定できます。詳細については、「ライフサイクルの設定」をご参照ください。
パラメーター
説明
[実行の有効化]
コンテナが起動する前に実行するコマンドとその引数を指定します。
[起動後処理]
コンテナが起動した後に実行するコマンドを指定します。
[PreStop 処理]
コンテナが終了する前に実行するコマンドを指定します。
-
(オプション) ボリューム セクションで、コンテナにボリュームをマウントします。
-
(任意) ログの設定 セクションで、採集配置 と カスタマイズTag を設定します。
パラメーター
説明
収集設定
-
[ログライブラリ]: Simple Log Service に対応するログストアを作成し、収集されたログを保存します。
-
[容器内のログパス]: stdout およびテキストログをサポートします。
-
stdout:コンテナからの標準出力ログを収集します。
-
テキストログ:コンテナ内の指定されたパスからログを収集します。この例では、
/var/log/nginx配下のすべてのテキストログを収集し、ワイルドカード文字に対応しています。
-
カスタムタグ
カスタムタグを設定することもできます。設定すると、これらのタグはコンテナログに含まれます。カスタムタグは、分析時にログを分類し、統計やフィルタリングを容易にするのに役立ちます。
-
-
次 をクリックして、上級 ウィザードに進みます。
ステップ 3:詳細設定の完了
上級 ウィザードページで、アクセス、スケーリング、スケジューリング、およびラベル/アノテーションを設定します。
-
[アクセス制御] セクションで、バックエンド Pod の公開方法を設定します。
バックエンド Pod の公開方法を設定できます。この例では、ClusterIP と Ingress を使用して、インターネットからアクセスできる Nginx アプリケーションを作成します。
-
Service の設定:サービス の横にある 作成する をクリックして、Service のパラメーターを設定します。
-
Ingress の設定:Ingress の横にある 作成する をクリックして、バックエンド Pod のルーティングルールを設定します。
-
-
(オプション) スケーリング セクションで、負荷の変動に応じたアプリケーション要件を満たすために [HPA] を有効にするかどうかを設定します。
-
Container Service for Kubernetes (ACK) はメトリックベースのスケーリングをサポートしています。これにより、コンテナの CPU とメモリ使用率に基づいて Pod 数が自動的に調整されます。
説明オートスケーリングを有効にするには、コンテナのリソース要求を指定する必要があります。指定しない場合、オートスケーリングは機能しません。
パラメーター
説明
[メトリック]
CPU とメモリをサポートしています。リソース要求のタイプと一致する必要があります。
[トリガー条件]
リソース使用率 (パーセンテージ) のしきい値です。これを超えると、システムはスケールアウトします。
[最大レプリカ]
このワークロードタイプでスケールアウトできるコンテナの最大数です。
[最小レプリカ]
このワークロードタイプでスケールインできるコンテナの最小数です。
-
ACK は、特定の時刻に Kubernetes クラスターを自動的にスケーリングするスケジュールされたスケーリング (CronHPA) もサポートしています。スケジュールされたスケーリングを有効にする前に、ack-kubernetes-cronhpa-controller アドオンをインストールしてください。詳細については、「Scheduled scaling (CronHPA)」をご参照ください。
-
-
(オプション) Labels and Annotations セクションで、追加 をクリックして Pod ラベルとアノテーションを設定します。
-
作成する をクリックします。
ステップ 4:アプリケーション情報の表示
アプリケーションの作成後、デフォルトで作成完了ページにリダイレクトされます。詳細の表示 をクリックすると、デプロイ詳細ページに移動します。
また、デプロイメント ページでもデプロイメントを表示できます。対象のデプロイメントの名前をクリックするか、アクション 列の 詳細 をクリックすると、アプリケーション詳細ページに移動します。
YAML を使用して作成
ACS のテンプレートオーケストレーションでは、アプリケーションに必要なリソースオブジェクトを定義し、ラベルセレクターなどのメカニズムを使用して、それらを 1 つの完全なアプリケーションとしてまとめます。
この例では、Deployment と Service を含むオーケストレーションテンプレートを使用して Nginx アプリケーションを作成する方法について説明します。Deployment が Pod リソースを作成し、Service がそれらの Pod にバインドして、完全な Nginx アプリケーションを構成します。
-
ACS コンソールにログインします。左側のナビゲーションペインで、クラスターリストをクリックします。
-
クラスターリスト ページで、目的のクラスターの名前をクリックします。左側のナビゲーションペインで、ワークロード > デプロイメント を選択します。
-
デプロイメント ページで、右上隅の YAML のリソースの作成 をクリックします。
-
作成する ページで、テンプレートを設定し、作成するをクリックします。
-
[サンプルテンプレート]:ACS は、迅速にデプロイできるよう、さまざまなリソースタイプに対応した Kubernetes YAML のサンプルを提供します。また、Kubernetes 標準に従って独自の YAML を作成することもできます。
-
[ワークロードの作成]: この機能を使用すると、YAML テンプレートを迅速に定義できます。
-
[既存テンプレートの使用]: 既存のオーケストレーションテンプレートをインポートします。
-
[テンプレートの保存]: 設定したオーケストレーションテンプレートを保存します。
以下のサンプル YAML ファイルでは、Nginx アプリケーションを定義しています。これを使用して、Nginx アプリケーション用の Deployment を迅速に作成できます。デフォルトでは、CLB タイプの LoadBalancer Service が作成されます。
説明-
ACS は Kubernetes の YAML オーケストレーションをサポートしています。1 つのテンプレートで複数のリソースオブジェクトを定義するには、
---セパレーターを使用します。 -
(オプション) Volume を介してボリュームをマウントする場合、デフォルトではマウントディレクトリ内のファイルは上書きされます。既存のファイルを保持するには、
subPathパラメーターを設定します。
-
-
作成する をクリックすると、デプロイステータスが表示されます。
kubectl
kubectl コマンドを使用して、アプリケーションを作成および表示できます。
-
クラスターに接続します。詳細については、「クラスター kubeconfig の取得と kubectl を使用した接続」または「CloudShell で kubectl を使用した Kubernetes クラスターの管理」をご参照ください。
-
次のコマンドを実行して、コンテナを起動します。この例では、コンテナは Nginx Web サーバーを実行します。
kubectl create deployment nginx --image=registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest -
次のコマンドを実行して、コンテナのサービスエンドポイントを作成します。
--type=LoadBalancerを指定すると、Nginx コンテナにトラフィックをルーティングする Alibaba Cloud SLB が作成されます。kubectl expose deployment nginx --port=80 --target-port=80 --type=LoadBalancer -
次のコマンドを実行して、実行中の nginx Pod を一覧表示します。
kubectl get pod |grep nginx期待される出力:
NAME READY STATUS RESTARTS AGE nginx-2721357637-d**** 1/1 Running 1 9h