本記事では、Kubernetes クラスタ上で nginx の Deployment と Service を構築し、外部からアクセスするまでの一連の手順を解説します。実際に利用する yaml ファイルのサンプルと、各フィールドの意味も丁寧に解説します。
1. nginx Deployment の作成
まず、nginx Pod を管理する Deployment を作成します。
apiVersion: apps/v1
kind: Deployment
metadata:
name: nginx-deployment # Deployment の名称
labels: # リソースの識別に使われるラベル
app: nginx
spec:
replicas: 2
selector:
matchLabels:
app: nginx
template:
metadata:
labels:
app: nginx
spec:
containers:
- name: nginx
image: nginx:latest
ports:
- containerPort: 80
ポイント解説：
-
labelsにより、後述の Service がこの Pod を選択できます。 -
replicasで起動する Pod の数を指定しています。
2. Service の作成（NodePort タイプ）
次に、Pod に外部からアクセスするための Service を作成します。ここでは NodePort タイプを使用します。
apiVersion: v1
kind: Service
metadata:
name: nginx-service
labels:
app: nginx
spec:
selector:
app: nginx # Deployment で定義したラベルと一致させる
ports:
- name: nginx-port
protocol: TCP
port: 80
targetPort: 80
nodePort: 32600
type: NodePort
フィールドの意味：
-
port: Cluster 内で Service が公開するポート。 -
targetPort: Pod がリッスンしているポート。 -
nodePort: 外部からアクセスするためのポート（30000-32767 の範囲）。
-はリスト形式でポートを複数定義できることを示します。
3. 適用と確認
kubectl apply -f nginx-deployment.yaml
kubectl apply -f nginx-service.yaml
kubectl get pods -o wide
kubectl get services -o wide
nginx-service が表示され、EXTERNAL-IP と PORT(S) の情報が確認できれば成功です。
4. 動作確認
以下のコマンドで、実際に nginx にアクセスできるか確認します。
curl http://<任意ノードのIP>:32600
クラウド利用時の注意
クラウド環境（AWS, GCP 等）では、セキュリティグループなどで 32600 ポートのアクセス許可が必要です。
5. 補足：kubectl get の便利なオプション
- 全ての namespace のリソースを表示：
kubectl get deployments --all-namespaces
kubectl get pods --all-namespaces
- 特定 namespace のリソースを表示：
kubectl get deployments -n kube-system
kubectl get pods -n kube-system
- 略記の利用例：
kubectl get po pod1 # "pods" は "po" と省略可
おわりに
本記事では、nginx Deployment と NodePort タイプの Service の作成から、外部アクセスの確認方法までを丁寧に解説しました。
Kubernetes における Service やラベルセレクタの概念をしっかり理解することで、柔軟でスケーラブルなアプリケーション運用が可能になります。