このページの改善にご協力ください
本ユーザーガイドの改善にご協力いただけませんか? すべてのページの右側のペインにある GitHub リンクで、このページの編集を選択してください。皆さまにご協力いただくことで、あらゆる人々に使いやすいユーザーガイドになります。
このトピックでは、サンプルアプリケーションを Linux ノードのクラスターにデプロイします。
前提条件
-
既存の少なくとも 1 つのノードがある Kubernetes クラスター。既存の Amazon EKS クラスターがない場合は、Amazon EKS の使用を開始する のガイドの 1 つを使用して Amazon EKS クラスターをデプロイできます。
-
コンピュータに
Kubectl
がインストールされている。詳細については、「kubectl および eksctl のセットアップ」を参照してください。 -
クラスターと通信できるように
Kubectl
が設定されている。詳細については、「kubeconfig ファイルを作成して kubectl を EKS クラスターに接続する」を参照してください。 -
サンプルワークロードを Fargate にデプロイする予定の場合は、名前を変更しない限り、このチュートリアルで作成したのと同じ名前空間
eks-sample-app
を含む既存の Fargate プロファイルが必要です。Amazon EKS の使用を開始する のいずれかを使用してクラスターを作成した場合は、新しいプロファイルを作成するか、既存のプロファイルに名前空間を追加する必要があります。これは、入門ガイドで作成されたプロファイルでは、このチュートリアルで使用される名前空間が指定されていないためです。VPC には、少なくとも 1 つのプライベートサブネットも必要です。
多くの変数は次のステップで変更できますが、変数値は、指定された場合のみ変更することをお勧めします。KubernetesPods、デプロイ、およびサービスについて理解を深めたら、他の値を変更して試すことができます。
名前空間を作成します。
名前空間を使用すると、Kubernetes 内のリソースをグループ化できます。詳細については、「Kubernetes ドキュメント」の「名前空間namespace
の値が eks-sample-app
であることを確認します。
kubectl create namespace eks-sample-app
Kubernetes デプロイメントを作成する
Kubernetes デプロイを作成する。このサンプルのデプロイでは、パブリックリポジトリからコンテナイメージをプルし、その 3 つのレプリカ (個別の Pods) をクラスターにデプロイします。詳細については、「Kubernetes ドキュメント」の「デプロイ
-
次の内容を
eks-sample-deployment.yaml
という名前のファイルに保存します。サンプルアプリケーションのコンテナではネットワークストレージを使用しませんが、それを使用する必要があるアプリケーションが存在する場合があります。詳細については、「クラスターのためにアプリケーションデータを保存する」を参照してください。-
kubernetes.io/arch
キーの下のamd64
またはarm64
values
は、アプリケーションをいずれかのハードウェアアーキテクチャにデプロイできることを意味します (クラスター内に両方がある場合)。これは、このイメージがマルチアーキテクチャイメージであるため可能ですが、すべてがそうであるわけではありません。イメージを取得するリポジトリ内のイメージの詳細を表示することで、イメージがサポートされているハードウェアアーキテクチャを判別できます。ハードウェアアーキテクチャのタイプをサポートしないイメージをデプロイする場合、またはイメージをデプロイしない場合は、そのタイプをマニフェストから削除します。詳細については、「Kubernetes ドキュメント」の「よく知られているラベル、注釈、テイント 」を参照してください。 -
kubernetes.io/os: linux
nodeSelector
は、クラスターに、例えば、Linux ノードと Windows ノードがある場合、イメージは Linux ノードにのみデプロイされることを意味します。詳細については、「Kubernetes ドキュメント」の「よく知られているラベル、注釈、テイント」を参照してください。 apiVersion: apps/v1 kind: Deployment metadata: name: eks-sample-linux-deployment namespace: eks-sample-app labels: app: eks-sample-linux-app spec: replicas: 3 selector: matchLabels: app: eks-sample-linux-app template: metadata: labels: app: eks-sample-linux-app spec: affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: kubernetes.io/arch operator: In values: - amd64 - arm64 containers: - name: nginx image: public.ecr.aws/nginx/nginx:1.23 ports: - name: http containerPort: 80 imagePullPolicy: IfNotPresent nodeSelector: kubernetes.io/os: linux
-
-
デプロイマニフェストをクラスターに適用します。
kubectl apply -f eks-sample-deployment.yaml
サービスを作成する
サービスを利用すると、単一の IP アドレスまたは名前を使用して、すべてのレプリカにアクセスできます。詳細については、「Kubernetes ドキュメント」の「サービス
-
次の内容を
eks-sample-service.yaml
という名前のファイルに保存します。Kubernetes は、クラスター内からのみアクセスできる独自の IP アドレスをサービスに割り当てます。クラスターの外部からサービスにアクセスするには、AWS Load Balancer Controller をデプロイして、アプリケーションまたはネットワークトラフィックをサービスに負荷分散します。apiVersion: v1 kind: Service metadata: name: eks-sample-linux-service namespace: eks-sample-app labels: app: eks-sample-linux-app spec: selector: app: eks-sample-linux-app ports: - protocol: TCP port: 80 targetPort: 80
-
サービスマニフェストをクラスターに適用します。
kubectl apply -f eks-sample-service.yaml
作成されたリソースを確認する
-
eks-sample-app
名前空間内に存在するすべてのリソースを表示します。kubectl get all -n eks-sample-app
出力例は次のとおりです。
NAME READY STATUS RESTARTS AGE pod/eks-sample-linux-deployment-65b7669776-m6qxz 1/1 Running 0 27m pod/eks-sample-linux-deployment-65b7669776-mmxvd 1/1 Running 0 27m pod/eks-sample-linux-deployment-65b7669776-qzn22 1/1 Running 0 27m NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/eks-sample-linux-service ClusterIP 10.100.74.8 <none> 80/TCP 32m NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/eks-sample-linux-deployment 3/3 3 3 27m NAME DESIRED CURRENT READY AGE replicaset.apps/eks-sample-linux-deployment-776d8f8fd8 3 3 3 27m
出力では、前の手順でデプロイしたサンプルマニフェストで指定されたサービスとデプロイが表示されます。また、3 つの Pods も表示されます。これは、サンプルマニフェストで
3
replicas
が指定されたためです。Pods についての詳細は、「Kubernetes ドキュメント」の「ポッド」を参照してください。Kubernetes は、サンプルマニフェストで指定されていない場合でも、自動的に replicaset
リソースを作成します。ReplicaSets
の詳細については、「Kubernetesドキュメント」の「ReplicaSet」を参照してください。 注記
Kubernetes は、マニフェストで指定したレプリカの数を維持します。本稼働デプロイで、Kubernetes を使用してレプリカ数を水平にスケーリングしたり、Pods のコンピューティングリソースを垂直にスケーリングしたりする場合は、「Horizontal Pod Autoscaler を使用してポッドデプロイをスケールする」と「Vertical Pod Autoscaler でポッドリソースを調整する」を使用します。
-
デプロイされたサービスの詳細を表示します。
kubectl -n eks-sample-app describe service eks-sample-linux-service
出力例は次のとおりです。
Name: eks-sample-linux-service Namespace: eks-sample-app Labels: app=eks-sample-linux-app Annotations: <none> Selector: app=eks-sample-linux-app Type: ClusterIP IP Families: <none> IP: 10.100.74.8 IPs: 10.100.74.8 Port: <unset> 80/TCP TargetPort: 80/TCP Endpoints: 192.168.24.212:80,192.168.50.185:80,192.168.63.93:80 Session Affinity: None Events: <none>
前の出力では、
IP:
の値は、クラスター内の任意のノードまたは Pod からアクセスできる一意の IP アドレスですが、クラスターの外からはアクセスできません。Endpoints
の値は、VPC 内からサービスの一部である Pods に割り当てられる IP アドレスです。 -
前のステップで 名前空間を表示 したときに、出力にリストされた Pods のうち、1 つの詳細を表示します。
776d8f8fd8-78w66
を、Pods の 1 つに対して返された値に置き換えます。kubectl -n eks-sample-app describe pod eks-sample-linux-deployment-65b7669776-m6qxz
簡略化された出力例
Name: eks-sample-linux-deployment-65b7669776-m6qxz Namespace: eks-sample-app Priority: 0 Node: ip-192-168-45-132.us-west-2.compute.internal/192.168.45.132 [...] IP: 192.168.63.93 IPs: IP: 192.168.63.93 Controlled By: ReplicaSet/eks-sample-linux-deployment-65b7669776 [...] Conditions: Type Status Initialized True Ready True ContainersReady True PodScheduled True [...] Events: Type Reason Age From Message ---- ------ ---- ---- ------- Normal Scheduled 3m20s default-scheduler Successfully assigned eks-sample-app/eks-sample-linux-deployment-65b7669776-m6qxz to ip-192-168-45-132.us-west-2.compute.internal [...]
前の出力では、
IP:
の値は CIDR ブロックから Pod に割り当てられる一意の IP です。CIDR ブロックは、ノードが存在するサブネットに割り当てられています。異なる CIDR ブロックから Pods の IP アドレスを割り当てたい場合は、デフォルトの動作を変更できます。詳細については、「カスタムネットワーキングを使用して代替サブネットにPodsをデプロイする」を参照してください。また、Kubernetes スケジューラーが IP アドレス192.168.45.132
を使用してNode
上の Pod をスケジュールしたことを確認できます。ヒント
コマンドラインを使用する代わりに、Pods、サービス、デプロイ、その他の Kubernetes リソースに関する多くの詳細を AWS Management Console に表示できます。詳細については、「AWS Management Console 内の Kubernetes リソースを表示する」を参照してください。
ポッドでシェルを実行する
-
前の手順で説明した Pod でシェルを実行し、
65b7669776-m6qxz
をいずれかの Pods の ID に置き換えます。kubectl exec -it eks-sample-linux-deployment-65b7669776-m6qxz -n eks-sample-app -- /bin/bash
-
Pod シェルから、前のステップでデプロイと共にインストールされたウェブサーバーからの出力を表示します。サービス名のみ指定する必要があります。デフォルトでは、Amazon EKS クラスターとともにデプロイされる CoreDNS によって、サービスの IP アドレスに解決されます。
curl eks-sample-linux-service
出力例は次のとおりです。
<!DOCTYPE html> <html> <head> <title>Welcome to nginx!</title> [...]
-
Pod シェルから、Pod の DNS サーバーを表示します。
cat /etc/resolv.conf
出力例は次のとおりです。
nameserver 10.100.0.10 search eks-sample-app.svc.cluster.local svc.cluster.local cluster.local us-west-2.compute.internal options ndots:5
前の出力では、クラスターにデプロイされたすべての Pods に対して、
10.100.0.10
がnameserver
として自動的に割り当てられます。 -
exit
を入力して、Pod の接続を切断します。 -
サンプルアプリケーションの使用が終了したら、次のコマンドを使用して、サンプルの名前空間、サービス、デプロイを削除できます。
kubectl delete namespace eks-sample-app
次のステップ
サンプルアプリケーションをデプロイしたら、次の演習の一部を試すことができます。