CircleCI Server v3.x - 初めてのクラスタの作成 (任意)
ここでは、Kubernetes クラスタをセットアップしたことがない方のために、簡単なヒントをご紹介します。
ステップ 1 - 作成
Amazon EKS
CircleCI では、AWS で初めてクラスタをセットアップする場合、eksctl の使用をお勧めしています。 eksctl を使用すると、セキュリティ グループの選択だけでなく VPC の作成も自動で行われます。
クラスタを作成する前に、次の手順を完了してください。
フラグを使用してクラスタを作成します。
シンプルなクラスタを作成するには、次のコマンドを実行します。
eksctl create cluster
コマンドラインでは、他のフラグも使用できます。 詳細については、eksctl のhttps://eksctl.io/introduction</a>を参照してください。
設定ファイルを使用してクラスタを作成する
次のようなクラスタ設定ファイルを作成することもできます。
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig
metadata:
name: <your-cluster-name>
region: <aws-region>
managedNodeGroups:
- name: <nodegroup-name-1>
instanceType: <instance-type> # m5.large など。 利用可能なインスタンス タイプは https://aws.amazon.com/ec2/instance-types/ を参照
minSize: 4 # 詳細は https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-as-group.html#cfn-as-group-minsize を参照
maxSize: 6 # 詳細は https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-as-group.html#cfn-as-group-maxsize を参照他のクラスタ設定ファイルのサンプルについては、https://eksctl.io[eksctl.io] をご覧ください。
クラスタ設定ファイルが完成したら、保存して次のコマンドを実行します。
eksctl create cluster -f <your-cluster-config.yaml>
|
この原因は、https://docs.aws.amazon.com/ja_jp/cli/latest/userguide/cli-configure-files.html[AWS 認証情報]が無効であるか、利用中の IAM ユーザーに EKS クラスタの作成権限が付与されていないことです。 |
ステップ 2 - 検証
クラスタの作成が完了したら、kubectl の各種コマンドを実行して、クラスタ リソースを確認できるか試してください。
たとえば、クラスタ’のhttps://kubernetes.io/docs/tasks/access-application-cluster/access-cluster/#discovering-builtin-services[ビルトイン サービス]を表示するには、次のコマンドを実行します。
kubectl cluster-info
また、クラスタにワーカー ノードがアタッチされているかどうかを確認するには、次のコマンドを実行します。
kubectl get nodes -o wide
作成したクラスタの情報を確認する方法の詳細については、次のドキュメントを参照してください。
-
ステップ 2: リソースを表示する (AWS ドキュメント)
-
Accessing clusters (クラスタへのアクセス) (英語) (Kubernetes ドキュメント)
-
Cluster Management (クラスタの管理) (英語) (
kubectlドキュメント)
ドキュメントの改善にご協力ください
このガイドは、CircleCI の他のドキュメントと同様にオープンソースで、GitHub で使用できます。 ご協力いただき、ありがとうございます。
- このページの編集をご提案ください (最初に「コントリビューションガイド」をご覧ください)。
- ドキュメントの問題点を報告する、またはフィードバックやコメントを送信するには、GitHub で issue を作成してください。
- CircleCI は、ユーザーの皆様の弊社プラットフォームにおけるエクスペリエンスを向上させる方法を常に模索しています。 フィードバックをシェアするには、 弊社のリサーチ コミュニティーにご参加ください。
