12,504
回編集
差分
ナビゲーションに移動
検索に移動
==| [[Docker]] | [[KubernetesDocker コマンド]]==| [[Dockerネットワーク]] | [[WSL]] | [[MicroK8s]] | [[Multipass]] | ==[https://kubernetes.io/ja/ Kubernetes]==
===利用===<pre>====ローカルクラスタの作成====*ローカル仮想マシンを作成*[[Kubernetes]]を設定*kubectlを設定 > minikube start*VirtualBox[[File:0753_minikube$ kubectl apply -f sample-pod.png|400px]]yaml *Ubuntu+KVMpod/sample-pod configured[[File:Minikube_kvm.png|400px]]</pre>
==[[Kubernetes]]クライアント==*表示の拡張<pre>$ kubectl get pod --output wideNAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATESsample-pod 1/1 Running 2 24h 172.17.0.3 minikube <none> <none>*公式なクライアントは、kubectl</pre>*kubectlを使用してクラスターと対話できるようになりますダッシュボードに表示された*[[KubernetesFile:Kubernetes_label.png|600px]] APIと連携するコマンドラインツール*minikube から利用する場合 > minikube kubectl version
[[File:Minikube_dashboard.png | 400px]]
[[File:K8s_service.png | 400px]]===Podが起動しているか確認===*確認(Pod)
===公開サービスのURLを確認===*確認(ReplicaSet)
[[File:K8s_service_run.png | 400px]]
$ kubectl versionClient VersionapiVersion: version.Info{Major:"1", Minor:"18", GitVersion:"apps/v1.18.8", GitCommitkind:"9f2892aab98fe339f3bd70e3c470144299398ace", GitTreeStateDaemonSetmetadata:"clean", BuildDate name:"2020sample-08-13T16dsspec:12 selector:48Z", GoVersion matchLabels:"go1.13.15", Compiler app:"gc", Platformsample-app template:"linux/amd64"}Server Version metadata: version.Info{Major labels:"1", Minor app:"18", GitVersionsample-app spec:"v1.18.3", GitCommit containers:"2e7996e3e2712684bc73f0dec0200d64eec7fe40", GitTreeState - name:"clean", BuildDate:"2020nginx-05-20T12container image:43nginx:34Z", GoVersion:"go11.13.9", Compiler:"gc", Platform:"linux/amd64"}19
====ワーカーノードの表示====*クラスタ上の全のノードを表示確認
=====基本情報が最初に表示される=====<pre> Name: minikube$ kubectl get pv [[R]]oles: master Labels: beta.kubernetes.io/arch=amd64 beta.kubernetes.io/os=linux kubernetes.io/arch=amd64 kubernetes.io/hostname=minikube kubernetes.io/os=linux node-role.kubernetes.io/master= Annotations: kubeadm.alpha.kubernetes.io/cri-socket: /var/run/dockershim.sock node.alpha.kubernetes.io/ttl: 0 volumes.kubernetes.io/controller-managed-attach-detach: true CreationTimestamp: Mon, 05 Aug 2019 23:17:24 +0900 Taints: <none> Unschedulable: false=====ノード上で動いているオペレーションの情報が表示される=====*それぞれのノードが十分なディスクとメモリを持っているか*Kubernatesマスターに対して正常であるか Conditions: Type Status LastHeartbeatTime LastTransitionTime [[R]]eason Message ---- ------ ----------------- ------------------ ------ ------- MemoryPressure False Tue, 13 Aug 2019 01:01:05 +0900 Mon, 05 Aug 2019 23:17:15 +0900 KubeletHasSufficientMemory kubelet has sufficient memory available DiskPressure False Tue, 13 Aug 2019 01:01:05 +0900 Mon, 05 Aug 2019 23:17:15 +0900 KubeletHasNoDiskPressure kubelet has no disk pressure PIDPressure False Tue, 13 Aug 2019 01:01:05 +0900 Mon, 05 Aug 2019 23:17:15 +0900 KubeletHasSufficientPID kubelet has sufficient PID available [[R]]eady True Tue, 13 Aug 2019 01:01:05 +0900 Mon, 05 Aug 2019 23:17:15 +0900 Kubelet[[R]]eady kubelet is posting ready status Addresses: InternalIP: 10.0.2.15 Hostname: minikube=====マシンのキャパシティ情報の表示===== Capacity: cpu: 2 ephemeral-storage: 17784772Ki hugepages-2Mi: 0 memory: 2038624Ki pods: 110 Allocatable: cpu: 2 ephemeral-storage: 16390445849 hugepages-2Mi: 0 memory: 1936224Ki pods: 110=====ノード上のソフトウェアバージョンの表示===== System Info: [[Mac]]hine ID: 7ec5a55cfdc14693866eccf4e9a1228f System UUID: 2C88347D-32CC-4F26-9AEE-1FED259A233C Boot ID: 1da81daa-4519-4f04-afe0-64efecedd7e7 Kernel Version: 4.15.0 OS Image: Buildroot 2018.05No resources found in default namespace.3 Operating System: linux Architecture: amd64 Container [[R]]untime Version: docker:<//18.9.6 Kubelet Version: v1.15.0 Kube-Proxy Version: v1.15.0=====ノード上で動いているPod情報の表示===== Non-terminated Pods: (9 in total) Namespace Name CPU [[R]]equests CPU Limits Memory [[R]]equests Memory Limits AGE --------- ---- ------------ ---------- --------------- ------------- --- kube-system coredns-5c98db65d4-j24hp 100m (5%) 0 (0%) 70Mi (3%) 170Mi (8%) 7d1h kube-system coredns-5c98db65d4-phtm8 100m (5%) 0 (0%) 70Mi (3%) 170Mi (8%) 7d1h kube-system etcd-minikube 0 (0%) 0 (0%) 0 (0%) 0 (0%) 7d1h kube-system kube-addon-manager-minikube 5m (0%) 0 (0%) 50Mi (2%) 0 (0%) 7d1h kube-system kube-apiserver-minikube 250m (12%) 0 (0%) 0 (0%) 0 (0%) 7d1h kube-system kube-controller-manager-minikube 200m (10%) 0 (0%) 0 (0%) 0 (0%) 7d1h kube-system kube-proxy-wrgp5 0 (0%) 0 (0%) 0 (0%) 0 (0%) 7d1h kube-system kube-scheduler-minikube 100m (5%) 0 (0%) 0 (0%) 0 (0%) 7d1h kube-system storage-pro[[vi]]sioner 0 (0%) 0 (0%) 0 (0%) 0 (0%) 7d1h Allocated resources: (Total limits may be over 100 percent, i.e., overcommitted.) [[R]]esource [[R]]equests Limits -------- -------- ------ cpu 755m (37%) 0 (0%) memory 190Mi (10%) 340Mi (17%) ephemeral-storage 0 (0%) 0 (0%) Events: Type [[R]]eason Age From Message ---- ------ ---- ---- ------- Normal NodeHasSufficientMemory 7d1h (x8 over 7d1h) kubelet, minikube Node minikube status is now: NodeHasSufficientMemory Normal NodeHasNoDiskPressure 7d1h (x8 over 7d1h) kubelet, minikube Node minikube status is now: NodeHasNoDiskPressure Normal NodeHasSufficientPID 7d1h (x7 over 7d1h) kubelet, minikube Node minikube status is now: NodeHasSufficientPID Normal Starting 7d1h kube-proxy, minikube Starting kube-proxy. Normal Starting 12m kubelet, minikube Starting kubelet. Normal NodeHasSufficientMemory 12m (x8 over 12m) kubelet, minikube Node minikube status is now: NodeHasSufficientMemory Normal NodeHasNoDiskPressure 12m (x8 over 12m) kubelet, minikube Node minikube status is now: NodeHasNoDiskPressure Normal NodeHasSufficientPID 12m (x7 over 12m) kubelet, minikube Node minikube status is now: NodeHasSufficientPID Normal NodeAllocatableEnforced 12m kubelet, minikube Updated Node Allocatable limit across pods Normal Starting 11m kube-proxy, minikube Starting kube-proxypre>
==kubectlコマンド==
===Namespace===
*クラスタ内のオブジェクトを構造化
*kubectlはデフォルトではdefaultというNamespaceとやり取り
*--namespace で指定できる
===Context===
*デフォルトのNamespaceを恒久的に変更したい場合
*$HOME/.kube/config に保存される
===[[Kubernetes]] APIオブジェクトの参照===
*[[Kubernetes]]上にあるものは、すべてRESTFulリソースであらわされる
==Pod==
*同じ実行環境上で動くアプリケーションコンテナとストレージボリュームの集まりのこと
*Kubernetesクラスタ上では、コンテナではなくPodがデプロイの最小単位
*1つのPodないのコンテナは全て同じマシン上に配置される
*同じPod内のアプリケーションは、ネイティブなプロセス間通信チャネルで通信できるが、異なるPodのアプリケーションからは分離されている
===Pod単位で考える===
*WordPressとMySQLを同じPodに入れれば良いと考えるのはアンチパターンの1つ
*それぞれ別マシンで通信できればよく、WordPressとDBが同じ単位としてスケールする可能性も低い
*WordPress自体はステートレスなため、負荷が増大した場合、WordPressのPodを増やしてスケールさせれば良い
*通常は、Podを作る際に、コンテナが異なるマシンに配置されても正常に動作するかという点が判断基準
→Kubelet=
{{amazon|4873118409}}
{{amazon|B07HFS7TDT}}
*https://kubernetes.io/ja/
*コンテナ化されたアプリケーションのデプロイ、スケーリングなどの管理を自動化するプラットフォーム（コンテナオーケストレーションエンジン)
*https://knowledge.sakura.ad.jp/20955/
**Microsoft:Azure Container Ser[[vi]]ce
**Google:Google [[Kubernetes]] Engine
===[https://kubernetes.io/ja/docs/reference/kubectl/cheatsheet/ チートシート]===
*[https://kubernetes.io/ja/docs/reference/kubectl/cheatsheet/ チートシート]
===コンポーネント構成===
*https://kubernetes.io/docs/concepts/overview/components/
*https://www.slideshare.net/yokawasa/istio-114360124 から引用
[[File:kubernetes_component.png|600px]]
===宣言的なコードによる管理===
*YAMLやJSONの宣言的なマニフェストで、コンテナやリソースを管理できる[[YAML]]やJSONの宣言的なマニフェストで、コンテナやリソースを管理できる
===スケーリング/オートスケーリング===
*コンテナクラスタを形成して、複数のKubernetes Nodeを管理できる
*コンテナを Kubernetes Nodeにデプロイする際に、どのNodeに配置するかを決定するスケジューリングというステップがある
*コンテナのワークロードの特徴、Kubernetes Nodeの性能差を意識してスケジューリングを行うことができる
===リソース管理===
*コンテナ配置に特別指定がない場合、自動スケジューリングが行われるため、管理する必要がない
*オートスケール機能により、Kubernetesクラスタの、Kubernetes Nodeの増減も自動で行われる
===セルフヒーリング===
*標準でコンテナのプロセス管理を行っており、プロセス停止を検知すると、再度コンテナのスケジュールを行うことで自動的にコンテナを再デプロイする
*プロセス監視以外にも、HTTP・TCPや、シェルスクリプトによるヘルスチェックも可能
===サービスディスカバリーとロードバランシング===
*ロードバランシング機能（Service)を持っており、事前に指定した条件に合致するコンテナ群に対してルーティングを行う機能を提供する
*コンテナスケール時や、障害時のサービスへの追加、切り離しも自動で行うため、エンドポイント管理をKubernetesに任せることが可能
*コンテナを使用したシステム構築では、マイクロサービスアーキテクチャ採用が一般的、マイクロサービスが相互参照するために、サービスディスカバリー機能が有用
*マイクロサービスを定義されたマニフェストを元にシステム全体を連携させることが可能
===データ管理===
*バックエンドのデータ管理にetcdを利用している
==基礎==
*Kubernetes は、Kubernetes Master と Kubernetes Node の２種類のノードからから成り立っている
*Kubernetes Master は、APIエンドポイントの提供コンテナのスケジューリング、コンテナのスケーリングなどを担う
*Kubernetes Node は、Docker ホストに相当し実際にコンテナが稼働するノード
*Kubernetes クラスタを操作するには、kubectl と [[YAML]] か JSON 形式のマニフェストファイルを用いて、Kuebrnetes Masterにリソースの登録を行う
*kubectlは、マニフェストファイルの情報を元にKubernetes MasterのAPIにリクエストを送り、Kubernetesの操作を行う
*Kubernetes の API は一般的な RESTful API として実装されている
==構成==
===クラスタ===
*Kubernetesクラスターは以下の2種類のリソースで構成
**マスターがクラスターを管理する、マスターはクラスターの管理を担当
**ノードがアプリケーションを動かすワーカーとなる、ノードは、Kubernetesクラスターのワーカーマシンとして機能するVMまたは物理マシン
====Kubelet====
*各ノードにはKubeletがあり、これはノードを管理し、Kubernetesマスターと通信するためのエージェント
====デプロイ====
Kubernetesにアプリケーションをデプロイするときは、
#マスターにアプリケーションコンテナを起動するように指示
#マスターはコンテナがクラスターのノードで実行されるようにスケジュール
#ノードは、マスターが公開しているKubernetes APIを使用してマスターと通信
##エンドユーザーは、Kubernetes APIを直接使用して対話することもできます
====Kubernetes とリソース====
*Kubernetesでは、リソースを登録することで、コンテナの実行やロードバランサの作成が非同期に行われる
==Workloadsリソース==
*クラスタ上にコンテナを起動するために利用する
*内部的に利用されているものをのぞき、直接操作するものとしては、以下のリソースがある
**Pod
**ReplicationController
**ReplicaSet
**Deployment
**DaemonSet
**StatefulSet
**Job
**CronJob
===Pod===
*Workloadsリソースの最小単位
*一つ以上のコンテナから構成され、ネットワーク的に隔離されておらず、IPアドレスを共有する
*2つのコンテナが入ったPoｄを作成した場合、同一IPアドレスを持ち、お互い、localhostで通信できる
*多くの場合は、1つのPodに1つのコンテナを含めるが、補助するサブコンテナを複数含めることもある
==Discovery ＆ LBリソース==
*コンテナサービスディスカバリやクラスタの外部からもアクセス可能なエンドポイントなどを提供する
*利用者が直接利用するものとしては、Service と Ingress があり、Serviceは複数タイプが用意されている
*Service
{| class="wikitable"
|-
! scope="col"| Service
! 内容
|-
| ClusterIP
|
|-
| ExternalIP （ClusterIPの一種)
|
|-
| NodePort
|
|-
| LoadBalancer
|
|-
| Headless （None)
|
|-
| ExternalName
|
|-
| None-Selector
|
|-
|}
*Ingress
===KubernetesクラスタのネットワークとService===
====Kubernetesが構成するネットワーク====
*Pod内には複数のコンテナを内包できるが、同じPodであれば、同一IPが割り振られている
*同一Podコンテナへ通信を行う場合は、localhostあてに通信を行い、Podのコンテナから別Podコンテナへ通信を行う場合には、PodのIPアドレス宛に通信を行う
*Kubernetesクラスタは、クラスタを構成するとノードにPodのための内部ネットワークを自動的に構成する
*基本的にはノードごとに異なるネットワークセグメントを互いに通信できるよう構成する
*このような内部ネットワークが自動構成されるため、PodはServiceを利用しなくてもPod間通信を行うことが可能
====Serviceを利用することによるメリット====
*Podあてトラフィックのロードバランシング
*サービスディスカバリとクラスタ内DNS
*これらは、上記のどのService Typeからも利用できる
====Pod宛トラフィックのロードバランシング====
*Serviceは、複数のPodにロードバランシングを行う
*Serviceを利用すると、各PodのIPを毎回調べたり、宛先を設定するなど独自に実現しなくても、自動的に構成することができる
*Serviceは、ロードバランシングのエンドポイントも提供する
**外部ロードバランサーが払い出す仮想IP（Virtual IPアドレス)、クラスタ内のみで利用可能な仮想IPアドレス(ClusterIP)など
==Config & Storage リソース==
*設定や機密データをコンテナに埋め込んだり、永続ボリュームを提供する
*Secret と ConfigMap は Key-Value のデータ構造を持ち保存データが機密か一般化によって使い分ける
*Secret
*ConfigMap
*PersistentVolumeClaim
==Cluster リソース==
*クラスタ自体の振る舞いを定義
*Node
*Namespace
*PersistentVolume
*ResourceQuote
*ServiceAccount
*Role
*ClusterRole
*RoleBinding
*ClusterRoleBinding
*NetworkPolicy
==minikubeMetadataリソース==*https://github.com/kubernetes/minikubeクラスタ内の他のリソースの動作を制御する*ローカル開発や学習、テスト用のシンプルな[[Kubernetes]]シュミレータLimitRange*シングルノードクラスタで、インストールには、ローカルマシンにハイパーバイザーがインストールされていることHorizontalPodAutoscaler*VT-x/AMD-v [[仮想化]]がBIOSで有効化されていること。PodDisruptionBudget*[https://kubernetes.io/ja/docs/setup/learning-environment/minikube/ Minikubeを使用してローカル環境でKubernetesを動かす]CustomResourceDefinition===インストール=[[Minikube]]==*https://kubernetes.io/docs/tasks/tools/install-minikube/[[Minikube]]
==[[MicroK8s]]==Ubuntu + 仮想環境*[[MicroK8s]]==[[Kubectl]]==*[https://www.typea.info/blog/index.php/2020/08/22/ubuntu-kvm-bridge-network/ Ubuntu 仮想環境(KVM)構築[Kubectl]]
==[https://kubernetes.io/ja/docs/concepts/overview/working-with-objects/namespaces/ Namespace]==入手====*Kubernetesは、同一の物理クラスター上で複数の仮想クラスターの動作をサポートします。 この仮想クラスターをNamespaceと呼びます*作成:kubectl create namespace <名称>*削除:kubectl delete namespace <名称>
<pre>
$ curl kubectl create namespace samplenamespace/sample created$ kubectl get namespacesNAME STATUS AGEkube-system Active 66dkube-Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikubepublic Active 66dkube-linuxnode-amd64lease Active 66ddefault Active 66d$ sudo +x minkubesample Active 4s
</pre>
==[https://kubernetes.io/ja/docs/concepts/workloads/pods/ Pod]==インストール*https://kubernetes.io/ja/docs/concepts/workloads/pods/*同じ実行環境上で動くアプリケーションコンテナとストレージボリュームの集まりのこと*Kubernetesクラスタ上では、コンテナではなくPodがデプロイの最小単位*1つのPodないのコンテナは全て同じマシン上に配置される*同じPod内のアプリケーションは、ネイティブなプロセス間通信チャネルで通信できるが、異なるPodのアプリケーションからは分離されている===Pod単位で考える===*WordPressとMySQLを同じPodに入れれば良いと考えるのはアンチパターンの1つ*それぞれ別マシンで通信できればよく、WordPressとDBが同じ単位としてスケールする可能性も低い*WordPress自体はステートレスなため、負荷が増大した場合、WordPressのPodを増やしてスケールさせれば良い*通常は、Podを作る際に、コンテナが異なるマシンに配置されても正常に動作するかという点が判断基準 ===設定===*設定を行う箇所は、clusters,contexts,users*[[YAML]] もしくは JSONフォーマット*直接編集するだけでなく、kubectlから変更も可能*https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/#pod-v1-core<pre>apiVersion: v1clusters:- cluster: certificate-authority: /home/piroto/.minikube/ca.crt server: https://192.168.39.214:8443 name: minikubecontexts:- context: cluster: minikube user: minikube name: minikubecurrent-context: minikubekind: Configpreferences: {}users:- name: minikube user: client-certificate: /home/piroto/.minikube/profiles/minikube/client.crt client-key: /home/piroto/.minikube/profiles/minikube/client.key</pre>===マニフェストとリソースの作成===*sample-pod.yaml<pre>apiVersion: v1kind: Podmetadata: name: sample-podspec: containers: - name: nginx-container image: nginx:1.12</pre>====実行====*apply コマンドを利用すると、存在しなければ生成、更新があれば更新、変更なければ何もしないという挙動<pre>$ kubectl create -f sample-pod.yaml pod/sample-pod created</pre>*確認
<pre>
$ sudo install minikube kubectl get podNAME READY STATUS RESTARTS AGEsample-pod 1/usr/local/bin1 Running 0 42s
</pre>
====停止アノテーションとラベル===*各リソースに対してアノテーションとラベルというメタデータを付与することができる{| class="wikitable"!名称!概要|-|アノテーション|システムコンポーネントが使用するメタデータ.アノテーションを元に処理するシステムコンポーネントが存在しない場合は単なるメモ|-|ラベル|リソース管理に利用するメターデータ.リソースを分別するための情報|}*ユーザーがアノテーションを付与せず作成したリソースでも、下記のように様々なアノテーションが付与される<pre> > $ kubectl get deployments -o yaml hello-minikube stop====クラスタを削除====apiVersion: apps/v1kind: Deploymentmetadata: annotations: deployment.kubernetes.io/revision: "1" creationTimestamp: "2020-08-22T08:02:54Z" :</pre>*アノテーションとラベルをマニフェストに追記<pre>apiVersion: v1kind: Podmetadata: name: sample-pod annotations: annotation1: val1 annotation2: val2 labels: label1: lab1 label2: lab2spec: containers: - name: nginx-container image: nginx:1.19 > minikube delete</pre>
===kubectlインストール=Podの削除====<pre>$ kubectl delete -f sample-pod.yaml pod "sample-pod" deleted</pre>===2つのコンテナを内包したPod===*マニフェスト sample-2pod.yaml<pre>apiVersion: v1kind: Podmetadata: name: sample-2podspec: containers: - name: nginx-container image: nginx:1.19 - name: radis-container image: redis:6.0.7</pre>*適用<pre>$ kubectl apply -f sample-2pod.yaml pod/sample-2pod created</pre>*結果確認
<pre>
$ curl kubectl get pod -LO https://storage.googleapis.com/kubernetes-release/release/$(curl output wideNAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATESsample-s https:2pod 2//storage2 Running 0 7m40s 172.17.googleapis0.com/kubernetes6 minikube <none> <none>sample-releasepod 1/release/stable1 Running 2 2d 172.17.txt)/bin/linux/amd64/kubectl$ sudo chmod +x 0./kubectl$ sudo install kubectl /usr/local/bin3 minikube <none> <none>
</pre>
===ダッシュボードコンテナへのログインとコマンド実行===*-t 疑似端末（TTY)を生成し、-i 標準入力をコンテナに渡す* /bin/bashコマンドを実行する
<pre>
$ minikube dashboardkubectl exec sample-pod -i -t -- /bin/bashroot@sample-pod:/#
</pre>
===Kubernetes Deploymentを作る=[https://kubernetes.io/ja/docs/concepts/workloads/controllers/replicaset/ ReplicaSet]==*単純なHTTPサーバーであるechoserverという既存のイメージを使用して、Kubernetes Deploymentを作るhttps://kubernetes.io/ja/docs/concepts/workloads/controllers/replicaset/*Podのレプリカを作成するリソース*レプリカ数=3でスケールさせたReplicaSet<pre>apiVersion: apps/v1kind: ReplicaSetmetadata: name: sample-rsspec: replicas: 3 selector: matchLabels: app: sample-app template: metadata: labels: app: sample-portを使用して8080番ポートで公開app spec: containers: - name: nginx-container image: nginx:1.19 ports: - containerPort: 80</pre>＊作成<pre>$ kubectl apply -f sample-rs.yaml replicaset.apps/sample-rs created</pre>*確認**Podが3つ起動していることが確認できる
<pre>
$ kubectl create deployment helloget pods -minikube -output wideNAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATESsample-image=k8s2pod 2/2 Running 0 26h 172.17.gcr0.io6 minikube <none> <none>sample-pod 1/echoserver:1 Running 2 3d2h 172.1017.0.3 minikube <none> <none>deploymentsample-rs-9gxzs 1/1 Running 0 3m14s 172.17.apps0.7 minikube <none> <none>sample-rs-nsn86 1/hello1 Running 0 3m14s 172.17.0.9 minikube <none> <none>sample-rs-wcjsv 1/1 Running 0 3m14s 172.17.0.8 minikube created <none> <none>
</pre>
*ダッシュボードで確認[[File:K8s_deploykubernetes_replicaset.png | 400px600px]]
===Deploymentに接続するために、Serviceとして公開=[https://kubernetes.io/ja/docs/concepts/workloads/controllers/deployment/ Deployment]==*https://kubernetes.io/ja/docs/concepts/workloads/controllers/deployment/*複数のReplicaSetを管理することで、ローリングアップデートやロールバックを実現するリソース*Kubernetesで最も推奨されるコンテナの起動方法*1つのコンテナでもDeploymentを使用すべき*Deploymentは新しいバージョンのリリースを管理する仕組み*デプロイされたアプリケーションをバージョンをまたいで表現する**Pod単体では自動で再起動されないし、ReplicaSetでは、ローリングアップデートが利用できない**PodもReplicaSetも変更されないコンテナイメージを取り扱うために作られている*フロー*#新しいReplicaSetを作成*#新しいReplicaSetのPod数を徐々に増やす*#古いReplicaSetのPod数を徐々に減らす*#上記を繰り返す*#古いReplicaSetのレプリカ数を0で保つ<pre>apiVersion: apps/v1kind: Deploymentmetadata: name: sample-deployspec: replicas: 3 selector: matchLabels: app: sample-app template: metadata: labels: app: sample-app spec: containers: - name: nginx-container image: nginx:1.19 ports: - containerPort: 80</pre>*作成
<pre>
$ kubectl expose deployment helloapply -minikube f sample--type=NodePort --port=8080deploy.yaml servicedeployment.apps/hellosample-minikube exposedrs created
</pre>
<pre>
$ kubectl get pod--output wideNAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATESsample-deploy-5cc5cfccd7-6vq65 1/1 Running 0 33s 172.17.0.6 minikube <none> <none>hellosample-deploy-5cc5cfccd7-qjtbx 1/1 Running 0 33s 172.17.0.7 minikube <none> <none>sample-64b64df8c9deploy-jzm5v 5cc5cfccd7-szcx5 1/1 Running 0 11m33s 172.17.0.3 minikube <none> <none>
</pre>
<pre>
$ minikube service hellokubectl get replicaset -minikube -output wideNAME DESIRED CURRENT READY AGE CONTAINERS IMAGES SELECTORsample-deploy-5cc5cfccd7 3 3 3 2m34s nginx-urlhttpcontainer nginx://1921.168.39.214:3142919 app=sample-app,pod-template-hash=5cc5cfccd7
</pre>
*ダッシュボード[[File:kubernetes_deployment.png|600px]] ===クラスタのステータス=[https://kubernetes.io/ja/docs/concepts/workloads/controllers/daemonset/ DaemonSet]==*Serverとクライアントのバージョンhttps://kubernetes.io/ja/docs/concepts/workloads/controllers/daemonset/*ReplicaSetでは、Podの数が一致するとも確実に配置されるとも保証されない*DaemonSetは、ReplicaSetの特殊な形、各ノードにPodを一つづつ配置するリソース*各ノード上で必ず動作させたいプロセスのために利用することが多い
<pre>
</pre>
*クラスタを構成しているコンポーネントを確認作成
<pre>
$ kubectl get componentstatusNAME STATUS MESSAGE ERRORcontrollerapply -f sample-manager Healthy ok scheduler Healthy ok ds.yaml etcddaemonset.apps/sample-0 Healthy {"health":"true"} ds created
</pre>
<pre>
$ kubectl get nodesdaemonset --output wideNAME STATUS DESIRED CURRENT READY UP-TO-DATE AVAILABLE NODE SELECTOR ROLES AGE VERSION CONTAINERS IMAGES SELECTORminikube sample-ds Ready master 1 1 1 1 1 <none> 98s 3h13m nginx-container v1nginx:1.18.319 app=sample-app
</pre>
==[https://kubernetes.io/ja/docs/concepts/workloads/controllers/statefulset/ StatefulSet]==ノードの詳細情報====*https://kubernetes.io/ja/docs/concepts/workloads/controllers/statefulset/*データベースなどステートフルなワークロードに対応するためのリソース*ReplicaSetの特殊な形**作成されるPodのサフィックスは数字のインデックスが付与**データを永続化する仕組みを持つ**Pod名が変わらない<pre>apiVersion: apps/v1kind: StatefulSetmetadata: name: webspec: selector: matchLabels: app: sample-app serviceName: sample-stateful replicas: 3 template: metadata: labels: app: sample-app spec: terminationGracePeriodSeconds: 10 containers: - name: nginx image: nginx:1.19 ports: - containerPort: 80 name: web volumeMounts: - name: www mountPath: /usr/share/nginx/html volumeClaimTemplates: - metadata: name: www spec: accessModes: - ReadWriteOnce resources: requests: storage: 1G</pre>*作成<pre>$ kubectl apply -f sample-stateful.yaml statefulset.apps/web created</pre>*確認<pre>$ kubectl describe nodes [ノード名]get statefulset --output wideNAME READY AGE CONTAINERS IMAGESweb 0/3 2m19s nginx nginx:1.19</pre><q>running "VolumeBinding" filter plugin for pod "web-0": pod has unbound immediate PersistentVolumeClaims</q>*https://qiita.com/silverbirder/items/d3522237b28703a9adb6*PersistentVolumeは、データを永続的に保存しておく場所のリソース。マネージドサービスを利用すると、デフォルトでPresistentVolumeが用意されている*PersistentVolumeClaimsは、「PresistentVolumeを使わせて」というリソース*PresistentVolumeのnameを指定し、applyすることで、初めてマウントができる
==[https://kubernetes.io/ja/docs/concepts/storage/persistent-volumes/ 永続ボリューム(PersistentVolume)]=クラスタのコンポーネント=*https://kubernetes.io/ja/docs/concepts/storage/persistent-volumes/*ストレージが何から提供されているか、どのように消費されているかをユーザーと管理者から抽象化するAPIを提供===PersistentVolume(PV)===*ストレージクラスを使って管理者もしくは動的にプロビジョニングされるクラスターのストレージの一部*Nodeと同じようにクラスターリソースの一部*[[Kubernetes]]クラスタを構成する多くのコンポーネントが、[[Kubernetes]]自体を使ってデプロイされるPVを使う個別のPodとは独立したライフサイクルを持っている===PersistentVolumeClaim(PVC)===*ユーザーによって要求されるストレージ*Podと似ています。PodはNodeリソースを消費し、PVCはPVリソースを消費します*クレームは特定のサイズやアクセスモード(例えば、1ノードからのみ読み書きマウントができるモードや、複数ノードから読み込み専用マウントができるモードなどです)を要求することができます===実例===*kubehttps://kubernetes.io/docs/tasks/configure-pod-container/configure-persistent-volume-storage/====index.htmlをノード上に生成====<pre>$ minikube ssh$ sudo mkdir /mnt/data$ sudo sh -system Namesspace内で動作c "echo 'Hello from kubernetes storage' > /mnt/data/index.html"$ cat /mnt/data/index.htmlHello from kubernetes storage</pre>====[[Kubernetes]] proxyPersistentVolumeの生成====*クラスタ内のロードバランスされたSer[[vi]]ceにネットワークトラフィックをルーティングホストパスのPersistentVolumeを作成*Kubernetesは単一クラスターで、ホストパスを開発とテストでサポートする*ホストパスPersistentVolumeは、ファイルやディレクトリをネットワークアタッチストレージをエミュレートしたものとして使用する*プロダクションのクラスターでは、ホストパスは使用すべきでなく、クラスタ管理者により、用意されたネットワークリソース（Google Compute Engine persistenｔ disk) などを使用する*クラスタ管理者は、StorageClassesも動的プロビジョニングに使用することができる*ホストパスPersistentVolumeの例<pre>apiVersion: v1kind: PersistentVolumemetadata: name: sample-pv labels: type: localspec: storageClassName: manual capacity: storage: 1Gi accessModes: - ReadWriteOnce hostPath: path: "/mnt/data"</pre>*生成<pre>$ kubectl apply -f sample-pv.yaml persistentvolume/sample-pv created</pre>*確認<pre>$ kubectl get pv --output wideNAME CAPACITY ACCESS MODES RECLAIM POLICY STATUS CLAIM STORAGECLASS REASON AGE VOLUMEMODEsample-pv 1Gi RWO Retain Available manual 12s Filesystem</pre>====PersistentVolumeClaimの作成====<pre>apiVersion: v1kind: PersistentVolumeClaimmetadata: name: sample-pvcspec: storageClassName: manual accessModes: - ReadWriteOnce resources: requests: storage: 1Gi</pre>*クラスタ内の各ノードで動いている必要がある生成<pre>$ kubectl apply -f sample-pvc.yaml persistentvolumeclaim/sample-pvc created</pre>*DaemonSetというAPIオブジェクトが多くのクラスタではノードでプロキシを動作させるために利用される確認<pre>$ kubectl get pvc --output wideNAME STATUS VOLUME CAPACITY ACCESS MODES STORAGECLASS AGE VOLUMEMODEsample-pvc Bound sample-pv 1Gi RWO manual 52s Filesystem</pre>
==[[Docker]]==
*[[Docker]]
*[[Docker コマンド]]
*[[Docker ネットワーク]]
===Dockerデーモンの再利用によるローカルイメージの使用===
*[https://kubernetes.io/ja/docs/setup/learning-environment/minikube/#docker%E3%83%87%E3%83%BC%E3%83%A2%E3%83%B3%E3%81%AE%E5%86%8D%E5%88%A9%E7%94%A8%E3%81%AB%E3%82%88%E3%82%8B%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%82%A4%E3%83%A1%E3%83%BC%E3%82%B8%E3%81%AE%E4%BD%BF%E7%94%A8 Dockerデーモンの再利用によるローカルイメージの使用]
https://hub.docker.com/
==Tips==
*[[WSL|WSL2でKubernetes/Dockerを動かす]]
===クイックスタート===
*https://kubernetes.io/ja/docs/setup/learning-environment/minikube/
<pre>
piroto@jinmu:~$ kubectl get node
NAME STATUS ROLES AGE VERSION
minikube Ready master 14m v1.18.3
piroto@jinmu:~$ kubectl create deployment hello-minikube --image=k8s.gcr.io/echoserver:1.10
deployment.apps/hello-minikube created
piroto@jinmu:~$ kubectl get pod
NAME READY STATUS RESTARTS AGE
hello-minikube-64b64df8c9-42s98 0/1 ContainerCreating 0 11s
piroto@jinmu:~$ kubectl expose deployment hello-minikube --type=NodePort --port=8080
service/hello-minikube exposed
piroto@jinmu:~$ minikube service hello-minikube --url
http://192.168.39.238:30523
</pre>
*ローカル環境のクラスターについて詳細を確認するには、出力から得たURLをブラウザー上でコピーアンドペースト
[[File:Kubernetes quick start 01.png|600px]]
*Service,Deploymentの削除、クラスター停止、クラスター削除
<pre>
piroto@jinmu:~$ kubectl delete services hello-minikube
service "hello-minikube" deleted
piroto@jinmu:~$ kubectl delete deployment hello-minikube
deployment.apps "hello-minikube" deleted
piroto@jinmu:~$ minikube stop
ノード "minikube" を停止しています...
1台のノードが停止しました。
piroto@jinmu:~$ minikube delete
kvm2 の「minikube」を削除しています...
クラスタ "minikube" の全てのトレースを削除しました。
</pre>
===NodeでHello World===
*https://kubernetes.io/ja/docs/tutorials/hello-minikube/
© 2006 矢木浩人
