このページの改善にご協力ください
本ユーザーガイドの改善にご協力いただけませんか? このページの下部までスクロールし、[GitHub でこのページの編集] を選択します。皆さまにご協力いただくことで、あらゆる人々に使いやすいユーザーガイドになります。
Amazon EKS の使用を開始する – AWS Management Console と AWS CLI
このガイドでは、AWS Management Console と AWS CLI を使用して、Amazon Elastic Kubernetes Service (Amazon EKS) を使用開始するために必要なすべてのリソースを作成する方法を解説します。ここでは、各リソースを手動で作成します。このチュートリアルの終わりには、アプリケーションのデプロイが可能な、実行状態の Amazon EKS クラスターが完成します。
このガイドの手順に従うと、各リソースがどのように作成され、リソース間でどのようにやり取りするかを全面的に把握できます。大半のリソースを自動的に作成させたい場合には、クラスターとノードの作成に eksctl
CLI を使用します。詳細については、「Amazon EKS – eksctl の使用を開始する」を参照してください。
前提条件
このチュートリアルを開始する前に、Amazon EKS クラスターの作成と管理に必要な次のツールとリソースを、インストールおよび設定しておく必要があります。
-
AWS CLI – Amazon EKS など AWS のサービスを操作するためのコマンドラインツールです。詳細については、 ユーザーガイドの、AWS CLI のインストール、更新、およびアンインストールAWS Command Line Interfaceを参照してください。AWS CLI のインストール後は、設定も行っておくことをお勧めします。詳細については、 ユーザーガイドの
aws configure
でクイック設定AWS Command Line Interfaceを参照してください。なお、このページにある [update-kubeconfig] オプションを使用するには、AWS CLI v2 が必要です。 -
kubectl
- Kubernetes クラスターを操作するためのコマンドラインツール。詳細については、「kubectl および eksctl のセットアップ」を参照してください。 -
必要な IAM アクセス許可 – 使用している IAM セキュリティプリンシパルには、Amazon EKS の IAM ロール、サービスにリンクされたロール、AWS CloudFormation、VPC、その関連リソースを操作するための権限が必要になります。詳細については、「IAM ユーザーガイド」の「Amazon Elastic Kubernetes サービスのアクション、リソース、および条件キー」および「サービスにリンクされたロールの使用」を参照してください。このガイドのすべての手順は、1 つのユーザーとして実行する必要があります。現在のユーザーを確認するには、次のコマンドを実行します。
aws sts get-caller-identity
-
このトピック内の手順は、 Bash シェル内で実行することが推奨されます。Bash シェルを使用していない場合、行継続文字や、変数の設定と使用に関する方法など、一部のスクリプトコマンドのためにシェルの調整が必要となります。さらに、シェルの引用規則とエスケープ規則は異なる場合があります。詳細については、「AWS Command Line Interface ユーザーガイド」の「AWS CLI での文字列への引用符の使用」を参照してください。
ステップ 1: Amazon EKS クラスターを作成する
重要
可能な限りシンプルかつ迅速に使用を開始するため、このトピックでは、クラスターをデフォルトの設定で作成するステップについて説明します。本番で使用するクラスターを作成する前に、すべての設定内容に習熟した上で、要件を満たす設定でクラスターをデプロイすることをお勧めします。詳細については、「Amazon EKS クラスターを作成します。」を参照してください。一部の設定は、クラスターの作成時にのみ有効にできます。
クラスターを作成するには
-
Amazon EKS の要件を満たすように、パブリックサブネットとプライベートサブネットを持つ Amazon VPC を作成します。
を Amazon EKS でサポートされている AWS リージョン に置き換えます。AWS リージョン の一覧については、「AWS 全般的なリファレンスガイド」の「Amazon EKS エンドポイントとクォータ」を参照してください。region-code
は、好みの任意の名前で置き換えることができます。my-eks-vpc-stack
aws cloudformation create-stack \ --region
region-code
\ --stack-namemy-eks-vpc-stack
\ --template-url https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2020-10-29/amazon-eks-vpc-private-subnets.yamlヒント
前のコマンドが作成したすべてのリソースの一覧については、AWS CloudFormation コンソール (https://console.aws.amazon.com/cloudformation
) を開きます。
スタックを選択し、[リソース] タブを選択します。my-eks-vpc-stack
-
クラスター IAM ロールを作成し、必要な Amazon EKS IAM マネージドポリシーをそれにアタッチします。Amazon EKS によって管理される Kubernetes クラスターは、サービスで使用するリソースを管理するために、ユーザーに代わって他の AWS サービスを呼び出します。
-
次の内容を
という名前のファイルにコピーします。eks-cluster-role-trust-policy.json
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "eks.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
-
ロールを作成します。
aws iam create-role \ --role-name
myAmazonEKSClusterRole
\ --assume-role-policy-document file://"eks-cluster-role-trust-policy.json
" -
このロールに、必要な Amazon EKS 管理の IAM ポリシーをアタッチします。
aws iam attach-role-policy \ --policy-arn arn:aws:iam::aws:policy/AmazonEKSClusterPolicy \ --role-name
myAmazonEKSClusterRole
-
Amazon EKS コンソール (https://console.aws.amazon.com/eks/home#/clusters
) を開きます。 コンソールの右上に表示されている AWS リージョン が、クラスターを作成する AWS リージョン であることを確認します。異なる場合は、AWS リージョン 名の横にあるドロップダウンを展開し、使用する AWS リージョン を選択します。
-
[クラスターを追加]、[作成] の順に選択します。このオプションが表示されない場合は、まず左のナビゲーションペインの [クラスター] を選択します。
-
[クラスターの設定] ページで、次の手順を実行します。
-
[名前] に、クラスターの名前 (
my-cluster
など) を入力します。この名前には、英数字 (大文字と小文字が区別されます) とハイフンのみを使用できます。先頭の文字は英数字である必要があります。また、100 文字より長くすることはできません。名前は、クラスターを作成する AWS リージョン および AWS アカウント 内で一意である必要があります。 -
[クラスターサービスロール] で、「
myAmazonEKSClusterRole
」を選択します。 -
その他の設定はデフォルト値のままにし、[次へ] をクリックします。
-
-
[ネットワーキングを指定] ページで、以下の作業を行います。
-
前のステップで [VPC] ドロップダウンリストから作成した VPC の ID を選択します。この ID は
vpc-00x0000x000x0x000
|my-eks-vpc-stack-VPC
のような値です。 -
その他の設定はデフォルト値のままにし、[次へ] をクリックします。
-
-
[オブザーバビリティの設定]ページで、[次へ] を選択します。
-
[アドオンの選択] ページで、[次へ] を選択します。
アドオンの詳細については、「Amazon EKS アドオン」を参照してください。
-
[選択したアドオンセッティングの設定] ページで、[次へ] を選択します。
-
[確認して作成] ページで、[作成] をクリックします。
クラスターのプロビジョニングプロセスが完了するまで、数分の間、クラスター名の右側でステータスが [作成中] と表示されます。ステータスが [アクティブ] になるまで、次のステップに進まないでください。
注記
リクエストで指定したアベイラビリティーゾーンのいずれかに、Amazon EKS クラスターの作成に十分な容量がない場合には、エラーが表示されることがあります。このエラー出力には、新しいクラスターをサポートできるアベイラビリティーゾーンが表示されます。アカウント向けにサポートされているアベイラビリティーゾーンにある 2 つ以上のサブネットを使用して、クラスターを作成します。詳細については、「容量不足」を参照してください。
ステップ 2: 自分のコンピュータでクラスターとの通信を設定する
このセクションでは、クラスター用の kubeconfig
ファイルを作成します。このファイルの設定により、kubectl
CLI からクラスターへの通信ができるようになります。
先に進む前に、ステップ 1 で必ずクラスターの作成を正常に完了してください。
クラスターと通信するようにコンピュータを設定するには
-
クラスター用の
kubeconfig
ファイルを作成もしくは更新します。
を、クラスターを作成する AWS リージョン に置き換えます。region-code
を自分のクラスター名に置き換えます。my-cluster
aws eks update-kubeconfig --region
region-code
--namemy-cluster
デフォルトでは、
config
ファイルが~/.kube
に作成されるか、config
ファイルが既に~/.kube
に存在する場合には、その中に新しいクラスター設定が追加されます。 -
設定をテストします。
kubectl get svc
注記
認可またはリソースタイプのエラーが発生した場合は、トラブルシューティングトピックの「許可されていないか、アクセスが拒否されました (kubectl)」を参照してください。
出力例は次のとおりです。
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE svc/kubernetes ClusterIP 10.100.0.1 <none> 443/TCP
1m
ステップ 3: ノードを作成する
重要
可能な限りシンプルかつ迅速に使用を開始するため、このトピックでは、ノードをデフォルトの設定で作成するステップについて説明します。本番で使用するノードを作成する前に、すべての設定内容に習熟した上で、要件を満たす設定でノードをデプロイすることをお勧めします。詳細については、「ノードを使用してコンピューティングリソースを管理する」を参照してください。一部の設定は、ノードの作成時にのみ有効にできます。
クラスターの作成には、次のいずれかのノードタイプが使用できます。各タイプの詳細については、「ノードを使用してコンピューティングリソースを管理する」を参照してください。クラスターをデプロイした後に、他のノードタイプを追加できます。
-
Fargate - Linux - AWS Fargate で Linux アプリケーションを実行する場合は、このタイプのノードを選択します。Fargate は、Amazon EC2 インスタンスを管理せずに Kubernetes Pods をデプロイできるサーバーレスコンピューティングエンジンです。
-
マネージド型ノード - Linux - 実行する場合は、このタイプのノードを選択します。このガイドでは説明しませんが、Windows セルフマネージド型 ノードと Bottlerocket ノードをクラスターに追加することもできます。
ステップ 4: リソースを表示する
ノードと Kubernetes のワークロードを表示することができます。
ノードとワークロードを表示するには
-
左のナビゲーションペインで [クラスター] を選択します。[クラスター] のリストで
my-cluster
など、作成したクラスターの名前を選択します。 -
[
my-cluster
] ページで、次の項目を選択します。-
[コンピューティング] タブ – クラスターにデプロイした [ノード] が一覧表示されます。ノードの名前を選択すると、そのノードに関するより詳細な情報が表示されます。
-
[リソース] タブ - Amazon EKS クラスターにデフォルトでデプロイされたすべての Kubernetes リソースが表示されます。コンソールでリソースタイプを選択すると、その詳細を確認できます。
-
ステップ 5: リソースを削除する
このチュートリアルのために作成したクラスターとノードの使用が終了したら、作成したリソースを削除する必要があります。リソースを削除する前に、他の目的でこのクラスターを使用する場合は、次のステップ を参照してください。
このガイドで作成したリソースを削除するには
-
ここで作成した、いずれかのノードグループもしくは Fargate プロファイルを削除します。
-
Amazon EKS コンソール (https://console.aws.amazon.com/eks/home#/clusters
) を開きます。 -
左のナビゲーションペインで [クラスター] を選択します。クラスターのリストから
my-cluster
を選択します。 -
[コンピューティング] タブを開きます。
-
ノードグループを作成している場合は、 ノードグループ
を した上で、[削除] を選択します。「my-nodegroup
」と入力し、[削除] を選択します。my-nodegroup
-
作成した各 Fargate プロファイルを選択した後に、[削除] をクリックします。プロファイルの名前を入力した後に、[削除] をクリックします。
注記
続いて 2 つ目の Fargate プロファイルを削除する場合、最初のプロファイルの削除が完了するまで待機します。
-
ノードグループまたは Fargate プロファイルが削除されるまで続行しないでください。
-
-
クラスターを削除します。
-
左のナビゲーションペインで [クラスター] を選択します。クラスターのリストから
my-cluster
を選択します。 -
[クラスターの削除] を選択します。
-
と入力し、[削除] を選択します。クラスターが削除されるまで続行しないでください。my-cluster
-
-
作成した VPC AWS CloudFormation スタックを削除します。
-
https://console.aws.amazon.com/cloudformation
で AWS CloudFormation コンソール を開きます。 -
[
] スタックを選択してから、[削除] を選択します。my-eks-vpc-stack
-
[
my-eks-vpc-stack
の削除] 確認ダイアログボックスで、[スタックを削除] をクリックします。
-
-
作成した IAM ロールを削除します。
-
IAM コンソール (https://console.aws.amazon.com/iam/
) を開きます。 -
左のナビゲーションペインで、[ロール] を選択します。
-
リスト ([
myAmazonEKSClusterRole
]、および、[AmazonEKSFargatePodExecutionRole] または[myAmazonEKSNodeRole]
) から、作成した各ロールを選択します。[削除] を選択し、要求された確認テキストを入力した後で、[削除] をクリックします。
-
次のステップ
以下のトピックは、クラスターの機能を拡張するのに役立ちます。
クラスターを作成した IAM プリンシパルは、
kubectl
または AWS Management Console を使用して Kubernetes API サーバーを呼び出すことができる唯一のプリンシパルです。他の IAM プリンシパルがクラスターにアクセスできるようにする場合は、それらを追加する必要があります。詳細については、IAM ユーザーおよびロールに Kubernetes APIs へのアクセスを付与するおよび必要なアクセス許可を参照してください。サンプルアプリケーションをクラスターにデプロイします。
本番用にクラスターをデプロイする前に、クラスターとノードのすべての設定を理解しておくことをお勧めします。Amazon EC2 ノードへの SSH アクセスの有効化など一部の設定は、クラスターの作成時に行う必要があります。
クラスターのセキュリティを強化するには、サービスアカウントの IAM ロールを使用する Amazon VPC コンテナネットワークインターフェイスプラグインの設定を行ってください。