翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS Outposts のサポート **警告** EKS Managed Nodegroups は Outposts ではサポートされていません。 ## 既存のクラスターを AWS Outposts に拡張する AWS リージョンで実行されている既存の EKS クラスターを AWS Outposts に拡張するには、次のように、新しいノードグループ`nodeGroup.outpostARN`が Outposts にノードグループを作成できるように を設定します。 ``` # extended-cluster.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: existing-cluster region: us-west-2 nodeGroups: # Nodegroup will be created in an AWS region. - name: ng # Nodegroup will be created on the specified Outpost. - name: outpost-ng privateNetworking: true outpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" ``` ``` eksctl create nodegroup -f extended-cluster.yaml ``` この設定では、EKS コントロールプレーンは AWS リージョンで実行され、 `outpostARN`が設定されたノードグループは指定された Outpost で実行されます。Outposts でノードグループが初めて作成されるとき、eksctl は指定された Outpost にサブネットを作成して VPC を拡張します。これらのサブネットは、 が`outpostARN`設定したノードグループを作成するために使用されます。 既存の VPC を持つお客様は、Outposts でサブネットを作成し`nodeGroup.subnets`、次のように に渡す必要があります。 ``` # extended-cluster-vpc.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: extended-cluster-vpc region: us-west-2 vpc: id: vpc-1234 subnets: private: outpost-subnet-1: id: subnet-1234 nodeGroups: # Nodegroup will be created in an AWS region. - name: ng # Nodegroup will be created on the specified Outpost. - name: outpost-ng privateNetworking: true # Subnet IDs for subnets created on Outpost. subnets: [subnet-5678] outpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" ``` ## AWS Outposts でのローカルクラスターの作成 **注記** ローカルクラスターは Outpost ラックのみをサポートします。 **注記** コントロールプレーンが Outposts にある場合、Amazon Linux 2 のみがノードグループでサポートされています。Outposts のノードグループでは、EBS gp2 ボリュームタイプのみがサポートされています。 eksctl での [AWS Outposts](https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts.html) のサポートにより、EKS コントロールプレーンやワーカーノードなど、Kubernetes クラスター全体でローカルクラスターを作成し、AWS Outposts でローカルに実行できます。お客様は、AWS Outposts でローカルに実行されている EKS コントロールプレーンとワーカーノードの両方を使用してローカルクラスターを作成するか、Outposts でワーカーノードを作成することで、AWS リージョンで実行されている既存の EKS クラスターを AWS Outposts に拡張できます。 AWS Outposts で EKS コントロールプレーンとノードグループを作成するには、次のように `outpost.controlPlaneOutpostARN`を Outpost ARN に設定します。 ``` # outpost.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: outpost region: us-west-2 outpost: # Required. controlPlaneOutpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" # Optional, defaults to the smallest available instance type on the Outpost. controlPlaneInstanceType: m5d.large ``` ``` eksctl create cluster -f outpost.yaml ``` これにより、指定した Outpost に EKS コントロールプレーンとサブネットを作成するように eksctl に指示します。Outposts ラックは 1 つのアベイラビリティーゾーンに存在するため、eksctl はパブリックサブネットとプライベートサブネットを 1 つだけ作成します。eksctl は作成された VPC を[ローカルゲートウェイ](https://docs.aws.amazon.com/outposts/latest/userguide/outposts-local-gateways.html)に関連付けないため、eksctl は API サーバーに接続できず、ノードグループを作成できません。したがって、クラスターの作成中に にノードグループ`ClusterConfig`が含まれている場合、 コマンドは`--without-nodegroup`次のように で実行する必要があります。 ``` eksctl create cluster -f outpost.yaml --without-nodegroup ``` クラスターの作成後に eksctl が作成した VPC をローカルゲートウェイに関連付けて、API サーバーへの接続を有効にするのはお客様の責任です。このステップの後、 を使用してノードグループを作成できます`eksctl create nodegroup`。 必要に応じて、 のコントロールプレーンノード`outpost.controlPlaneInstanceType`または のノードグループのインスタンスタイプを指定できますが`nodeGroup.instanceType`、インスタンスタイプが Outpost に存在する必要があります。存在しない場合、eksctl はエラーを返します。デフォルトでは、eksctl はコントロールプレーンノードとノードグループに対して Outpost で使用可能な最小のインスタンスタイプを選択しようとします。 コントロールプレーンが Outposts にある場合、その Outpost にノードグループが作成されます。必要に応じて、 のノードグループの Outpost ARN を指定できます`nodeGroup.outpostARN`が、コントロールプレーンの Outpost ARN と一致する必要があります。 ``` # outpost-fully-private.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: outpost-fully-private region: us-west-2 privateCluster: enabled: true outpost: # Required. controlPlaneOutpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" # Optional, defaults to the smallest available instance type on the Outpost. controlPlaneInstanceType: m5d.large ``` ``` # outpost.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: outpost region: us-west-2 outpost: # Required. controlPlaneOutpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" # Optional, defaults to the smallest available instance type on the Outpost. controlPlaneInstanceType: m5d.large controlPlanePlacement: groupName: placement-group-name ``` ### 既存の VPC 既存の VPC を持つお客様は、次のように でサブネット設定を指定することで`vpc.subnets`、AWS Outposts でローカルクラスターを作成できます。 ``` # outpost-existing-vpc.yaml --- apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: outpost region: us-west-2 vpc: id: vpc-1234 subnets: private: outpost-subnet-1: id: subnet-1234 nodeGroups: - name: outpost-ng privateNetworking: true outpost: # Required. controlPlaneOutpostARN: "arn:aws:outposts:us-west-2:1234:outpost/op-1234" # Optional, defaults to the smallest available instance type on the Outpost. controlPlaneInstanceType: m5d.large ``` ``` eksctl create cluster -f outpost-existing-vpc.yaml ``` サブネットは、 で指定された Outpost に存在する必要があります。存在しない`outpost.controlPlaneOutpostARN`場合、eksctl はエラーを返します。サブネットのローカルゲートウェイにアクセスできる場合、または VPC リソースに接続できる場合は、クラスターの作成時にノードグループを指定することもできます。 ## ローカルクラスターでサポートされていない機能 + [アドオン](addons.md) + [サービスアカウントの IAM ロール](iamserviceaccounts.md) + [IPv6](vpc-ip-family.md) + [ID プロバイダー](https://github.com/eksctl-io/eksctl/blob/main/examples/27-oidc-provider.yaml) + [Fargate](fargate.md) + [KMS 暗号化](kms-encryption.md) + [ローカルゾーン](https://github.com/eksctl-io/eksctl/blob/main/examples/33-local-zones.yaml) + [Karpenter](eksctl-karpenter.md) + [インスタンスセレクタ](instance-selector.md) + アベイラビリティーゾーンは、デフォルトで Outpost アベイラビリティーゾーンに指定されているため、指定できません。 + `vpc.publicAccessCIDRs` と `vpc.autoAllocateIPv6` はサポートされていません。 + API サーバーへのパブリックエンドポイントアクセスはサポートされていません。ローカルクラスターはプライベートのみのエンドポイントアクセスでのみ作成できるためです。 ## 詳細情報 + [AWS Outposts での Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts.html) + [Amazon EKS on AWS Outposts のローカルクラスター](https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-local-cluster-overview.html) + [ローカルクラスターの作成](https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-local-cluster-create.html) + [Outpost でのセルフマネージド Amazon Linux ノードの起動](https://docs.aws.amazon.com/eks/latest/userguide/eks-outposts-self-managed-nodes.html)