このページの改善にご協力ください
本ユーザーガイドの改善にご協力いただけませんか? すべてのページの右側のペインにある GitHub リンクで、このページの編集を選択してください。皆さまにご協力いただくことで、あらゆる人々に使いやすいユーザーガイドになります。
このトピックでは、サンプルアプリケーションを Windows ノードのクラスターにデプロイします。
前提条件
-
既存の少なくとも 1 つのノードがある Kubernetes クラスター。既存の Amazon EKS クラスターがない場合は、Amazon EKS の使用を開始する のガイドの 1 つを使用して Amazon EKS クラスターをデプロイできます。クラスターと少なくとも 1 つの Amazon EC2 Windows ノードで Windows サポートを有効にする必要があります。
-
コンピュータに
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 デプロイを作成する
このサンプルのデプロイでは、パブリックリポジトリからコンテナイメージをプルし、その 3 つのレプリカ (個別の Pods) をクラスターにデプロイします。詳細については、「Kubernetes ドキュメント」の「デプロイ
-
次の内容を
eks-sample-deployment.yaml
という名前のファイルに保存します。サンプルアプリケーションのコンテナではネットワークストレージを使用しませんが、それを使用する必要があるアプリケーションが存在する場合があります。詳細については、「クラスターのためにアプリケーションデータを保存する」を参照してください。-
kubernetes.io/os: windows
nodeSelector
は、クラスターに、例えば、Windows ノードと Linux ノードがある場合、イメージは Windows ノードにのみデプロイされることを意味します。詳細については、「Kubernetes ドキュメント」の「よく知られているラベル、注釈、テイント」を参照してください。 apiVersion: apps/v1 kind: Deployment metadata: name: eks-sample-windows-deployment namespace: eks-sample-app labels: app: eks-sample-windows-app spec: replicas: 3 selector: matchLabels: app: eks-sample-windows-app template: metadata: labels: app: eks-sample-windows-app spec: affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: beta.kubernetes.io/arch operator: In values: - amd64 containers: - name: windows-server-iis image: mcr.microsoft.com/windows/servercore:ltsc2019 ports: - name: http containerPort: 80 imagePullPolicy: IfNotPresent command: - powershell.exe - -command - "Add-WindowsFeature Web-Server; Invoke-WebRequest -UseBasicParsing -Uri 'https://dotnetbinaries.blob.core.windows.net/servicemonitor/2.0.1.6/ServiceMonitor.exe' -OutFile 'C:\\ServiceMonitor.exe'; echo '<html><body><br/><br/><marquee><H1>Hello EKS!!!<H1><marquee></body><html>' > C:\\inetpub\\wwwroot\\default.html; C:\\ServiceMonitor.exe 'w3svc'; " nodeSelector: kubernetes.io/os: windows
-
-
デプロイマニフェストをクラスターに適用します。
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-windows-service namespace: eks-sample-app labels: app: eks-sample-windows-app spec: selector: app: eks-sample-windows-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-windows-deployment-65b7669776-m6qxz 1/1 Running 0 27m pod/eks-sample-windows-deployment-65b7669776-mmxvd 1/1 Running 0 27m pod/eks-sample-windows-deployment-65b7669776-qzn22 1/1 Running 0 27m NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE service/eks-sample-windows-service ClusterIP 10.100.74.8 <none> 80/TCP 32m NAME READY UP-TO-DATE AVAILABLE AGE deployment.apps/eks-sample-windows-deployment 3/3 3 3 27m NAME DESIRED CURRENT READY AGE replicaset.apps/eks-sample-windows-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-windows-service
出力例は次のとおりです。
Name: eks-sample-windows-service Namespace: eks-sample-app Labels: app=eks-sample-windows-app Annotations: <none> Selector: app=eks-sample-windows-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-windows-deployment-65b7669776-m6qxz
簡略化された出力例
Name: eks-sample-windows-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-windows-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-windows-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-windows-deployment-65b7669776-m6qxz -n eks-sample-app -- powershell.exe
-
Pod シェルから、前のステップでデプロイと共にインストールされたウェブサーバーからの出力を表示します。サービス名のみ指定する必要があります。デフォルトでは、Amazon EKS クラスターとともにデプロイされる CoreDNS によって、サービスの IP アドレスに解決されます。
Invoke-WebRequest -uri eks-sample-windows-service/default.html -UseBasicParsing
出力例は次のとおりです。
StatusCode : 200 StatusDescription : OK Content : < h t m l > < b o d y > < b r / > < b r / > < m a r q u e e > < H 1 > H e l l o E K S ! ! ! < H 1 > < m a r q u e e > < / b o d y > < h t m l >
-
Pod シェルから、Pod の DNS サーバーを表示します。
Get-NetIPConfiguration
省略された出力
InterfaceAlias : vEthernet [...] IPv4Address : 192.168.63.14 [...] DNSServer : 10.100.0.10
前の出力では、クラスターにデプロイされたすべての Pods に対して、
10.100.0.10
が DNS サーバーとして自動的に割り当てられます。 -
exit
を入力して、Pod の接続を切断します。 -
サンプルアプリケーションの使用が終了したら、次のコマンドを使用して、サンプルの名前空間、サービス、デプロイを削除できます。
kubectl delete namespace eks-sample-app
次のステップ
サンプルアプリケーションをデプロイしたら、次の演習の一部を試すことができます。