はじめに
この記事は「お家Kubernetes環境を作ろう」シリーズの1つです。前回はマルチノードクラスタ上でpodを立てるところまでを行いました。
今回は手元のminikube上にNext.js + Nginxのサーバーを立てていこうと思います。
完成品はGithub上に公開してありますので参考程度にどうぞ
https://github.com/piny940/infra/tree/main/kubernetes/portfolio
環境
- Ubuntu22.04
- minikube 1.32.0
- Docker 24.0.7
- Kubernetes v1.28.3
前提条件
- 動くDockerfileが用意できている
- dockerhubのアカウントを持っている
Dockerイメージをpush
まず、dockerhubでレポジトリを作成します。(このレポジトリ名は後で使います)
次にdocker buildでdockerイメージを作成します。
$ docker build .
作成されたイメージのIDを確認します。
$ docker images
タグをつけます。tagnameはバージョン管理で使用するため、yyyyMMddHHmmssの形にしました。
$ docker tag {imageID} {アカウント名}/{レポジトリ名}:{タグ名}
pushします。
$ docker push {アカウント名}/{レポジトリ名}:{タグ名}
minikubeを起動
minikube start --driver=docker
driverはdockerを使用することにしました。デフォルトのQEMUでは何だったか忘れましたが何かに対応してなくてできませんでした。
deployment.yamlを作成
apiVersion: apps/v1
kind: Deployment
metadata:
name: {アプリ名}
labels:
app: {アプリ名}
spec:
replicas: 1
selector:
matchLabels:
app: {アプリ名}
template:
metadata:
labels:
app: {アプリ名}
spec:
containers:
- name: app
image: {イメージ名}
ports:
- containerPort: {サーバーのポート番号}
イメージ名は{dockerhubのアカウント名}/{レポジトリ名}:{タグ名}の形で書きます。
これでkubectl apply -f deployment.yamlとするとdeploymentとpodが作成されます。
$ kubectl get deployment
NAME READY UP-TO-DATE AVAILABLE AGE
{アプリ名} 1/1 1 1 45h
service.yamlを作成
apiVersion: v1
kind: Service
metadata:
name: {アプリ名}
spec:
selector:
app: {アプリ名}
ports:
- name: http
protocol: TCP
port: {サーバーのポート番号}
targetPort: {サーバーのポート番号}
type: ClusterIP
typeはClusterIPを指定します。serviceのtypeについてはこの記事がわかりやすかったです。
https://www.ios-net.co.jp/blog/20230621-1179/
正常に作成されていることを確認します。
$ kubectl get svc
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
kubernetes ClusterIP 10.96.0.1 <none> 443/TCP 5d21h
{アプリ名} ClusterIP 10.97.105.94 <none> 4400/TCP 45h
ingress-nginx.yamlを作成
kubernetes上にnginxコンテナを作成してserviceに対してプロキシしたい場合は、ingress-nginxが便利です。
導入は概ねチュートリアルそのままで出来ます。
https://kubernetes.io/ja/docs/tasks/access-application-cluster/ingress-minikube/
まずはminikubeでingressを使えるようにします。
$ minikube addons enable ingress
次にingress-nginx.yamlを作成し、次のように記述します。
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: {アプリ名}
spec:
ingressClassName: nginx
rules:
- host: hello-world.info
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: {アプリ名}
port:
number: {サーバーのポート番号}
kubectl apply -f ingress-nginx.yamlでingressが立ち上がるはずです。
$ kubectl get ingress
NAME CLASS HOSTS ADDRESS PORTS AGE
{アプリ名} nginx hello-world.info 192.168.49.2 80 69s
これでアクセスできるように…と言いたいところなのですが、driverをdockerにしてminikubeを起動するとなぜか上手く動作しないらしいです。
そのため、代替手段として次のコマンドを使用します。
$ minikube service ingress-nginx-controller --url -n ingress-nginx
http://127.0.0.1:44897
http://127.0.0.1:43161
❗ Docker ドライバーを linux 上で使用しているため、実行するにはターミナルを開く必要があります。
これで表示されたアドレスにアクセスするとnginxの404が返ってくるはずです！
nextのアプリにアクセスするには次のようにホスト名を指定します。
$ curl {表示されたIPアドレス} -H 'Host: hello-world.info'
kustomization.yamlを作成
前章でNext + nginxのサーバーは立てられたのですが、マニフェストファイルがいくつもあると管理が大変になるため、kustomizeを導入することにします。
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: default
resources:
- deployment.yaml
- service.yaml
- ingress-nginx.yaml
これで環境が変わってもkubectl apply -k .とするだけでマニフェストの適用が完了します。
最後に
今回はminikube上でNextサーバーをnginxを通してアクセスできるようにしました。次回は今回作ったものをVPS上で再現していきたいと思います。