2020-01-21 04:39:36 +00:00
|
|
|
|
---
|
|
|
|
|
title: サービスとアプリケーションの接続
|
|
|
|
|
content_template: templates/concept
|
|
|
|
|
weight: 30
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
{{% capture overview %}}
|
|
|
|
|
|
|
|
|
|
## コンテナを接続するためのKubernetesモデル
|
|
|
|
|
|
|
|
|
|
継続的に実行され、複製されたアプリケーションの準備ができたので、ネットワーク上で公開することが可能になります。
|
|
|
|
|
Kubernetesのネットワークのアプローチについて説明する前に、Dockerの「通常の」ネットワーク手法と比較することが重要です。
|
|
|
|
|
|
|
|
|
|
デフォルトでは、Dockerはホストプライベートネットワーキングを使用するため、コンテナは同じマシン上にある場合にのみ他のコンテナと通信できます。
|
|
|
|
|
Dockerコンテナがノード間で通信するには、マシンのIPアドレスにポートを割り当ててから、コンテナに転送またはプロキシする必要があります。
|
|
|
|
|
これは明らかに、コンテナが使用するポートを非常に慎重に調整するか、ポートを動的に割り当てる必要があることを意味します。
|
|
|
|
|
|
2020-06-11 04:37:27 +00:00
|
|
|
|
複数の開発者やコンテナを提供するチーム間でポートの割り当てを調整することは、規模的に大変困難であり、ユーザが制御できないクラスターレベルの問題にさらされます。
|
2020-01-21 04:39:36 +00:00
|
|
|
|
Kubernetesでは、どのホストで稼働するかに関わらず、Podが他のPodと通信できると想定しています。
|
|
|
|
|
すべてのPodに独自のクラスタープライベートIPアドレスを付与するため、Pod間のリンクを明示的に作成したり、コンテナポートをホストポートにマップしたりする必要はありません。
|
|
|
|
|
これは、Pod内のコンテナがすべてlocalhostの相互のポートに到達でき、クラスター内のすべてのPodがNATなしで相互に認識できることを意味します。
|
|
|
|
|
このドキュメントの残りの部分では、このようなネットワークモデルで信頼できるサービスを実行する方法について詳しく説明します。
|
|
|
|
|
|
|
|
|
|
このガイドでは、シンプルなnginxサーバーを使用して概念実証を示します。
|
|
|
|
|
同じ原則が、より完全な[Jenkins CIアプリケーション](https://kubernetes.io/blog/2015/07/strong-simple-ssl-for-kubernetes)で具体化されています。
|
|
|
|
|
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture body %}}
|
|
|
|
|
|
|
|
|
|
## Podをクラスターに公開する
|
|
|
|
|
|
|
|
|
|
前の例でネットワークモデルを紹介しましたが、再度ネットワークの観点に焦点を当てましょう。
|
|
|
|
|
nginx Podを作成し、コンテナポートの仕様を指定していることに注意してください。
|
|
|
|
|
|
|
|
|
|
{{< codenew file="service/networking/run-my-nginx.yaml" >}}
|
|
|
|
|
|
|
|
|
|
これにより、クラスター内のどのノードからでもアクセスできるようになります。
|
|
|
|
|
Podが実行されているノードを確認します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f ./run-my-nginx.yaml
|
|
|
|
|
kubectl get pods -l run=my-nginx -o wide
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME READY STATUS RESTARTS AGE IP NODE
|
|
|
|
|
my-nginx-3800858182-jr4a2 1/1 Running 0 13s 10.244.3.4 kubernetes-minion-905m
|
|
|
|
|
my-nginx-3800858182-kna2y 1/1 Running 0 13s 10.244.2.5 kubernetes-minion-ljyd
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
PodのIPを確認します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get pods -l run=my-nginx -o yaml | grep podIP
|
|
|
|
|
podIP: 10.244.3.4
|
|
|
|
|
podIP: 10.244.2.5
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
クラスター内の任意のノードにSSH接続し、両方のIPにcurl接続できるはずです。
|
|
|
|
|
コンテナはノードでポート80を使用**していない**ことに注意してください。
|
|
|
|
|
また、Podにトラフィックをルーティングする特別なNATルールもありません。
|
|
|
|
|
つまり、同じcontainerPortを使用して同じノードで複数のnginx Podを実行し、IPを使用してクラスター内の他のPodやノードからそれらにアクセスできます。
|
|
|
|
|
Dockerと同様に、ポートは引き続きホストノードのインターフェイスに公開できますが、ネットワークモデルにより、この必要性は根本的に減少します。
|
|
|
|
|
|
|
|
|
|
興味があれば、これを[どのように達成するか](/docs/concepts/cluster-administration/networking/#how-to-achieve-this)について詳しく読むことができます。
|
|
|
|
|
|
|
|
|
|
## Serviceを作成する
|
|
|
|
|
|
|
|
|
|
そのため、フラットでクラスター全体のアドレス空間でnginxを実行するPodがあります。
|
|
|
|
|
理論的には、これらのPodと直接通信することができますが、ノードが停止するとどうなりますか?
|
|
|
|
|
Podはそれで死に、Deploymentは異なるIPを持つ新しいものを作成します。
|
|
|
|
|
これは、Serviceが解決する問題です。
|
|
|
|
|
|
|
|
|
|
Kubernetes Serviceは、クラスター内のどこかで実行されるPodの論理セットを定義する抽象化であり、すべて同じ機能を提供します。
|
|
|
|
|
作成されると、各Serviceには一意のIPアドレス(clusterIPとも呼ばれます)が割り当てられます。
|
|
|
|
|
このアドレスはServiceの有効期間に関連付けられており、Serviceが動作している間は変更されません。
|
|
|
|
|
Podは、Serviceと通信するように構成でき、Serviceへの通信は、ServiceのメンバーであるPodに自動的に負荷分散されることを認識できます。
|
|
|
|
|
|
2020-03-31 23:49:02 +00:00
|
|
|
|
2つのnginxレプリカのサービスを`kubectl expose`で作成できます:
|
2020-01-21 04:39:36 +00:00
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl expose deployment/my-nginx
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
service/my-nginx exposed
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
これは次のyamlを`kubectl apply -f`することと同等です:
|
|
|
|
|
|
|
|
|
|
{{< codenew file="service/networking/nginx-svc.yaml" >}}
|
|
|
|
|
|
|
|
|
|
この仕様は、`run:my-nginx`ラベルを持つ任意のPodのTCPポート80をターゲットとするサービスを作成し、抽象化されたサービスポートでPodを公開します(`targetPort`:はコンテナがトラフィックを受信するポート、`port`:は抽象化されたServiceのポートであり、他のPodがServiceへのアクセスに使用する任意のポートにすることができます)。
|
|
|
|
|
サービス定義でサポートされているフィールドのリストは[Service](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#service-v1-core) APIオブジェクトを参照してください。
|
|
|
|
|
|
|
|
|
|
Serviceを確認します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get svc my-nginx
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
|
|
|
|
my-nginx ClusterIP 10.0.162.149 <none> 80/TCP 21s
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
前述のように、ServiceはPodのグループによってサポートされています。
|
|
|
|
|
これらのPodはエンドポイントを通じて公開されます。
|
2020-03-27 06:08:22 +00:00
|
|
|
|
Serviceのセレクターは継続的に評価され、結果は`my-nginx`という名前のEndpointsオブジェクトにPOSTされます。
|
2020-01-21 04:39:36 +00:00
|
|
|
|
Podが終了すると、エンドポイントから自動的に削除され、Serviceのセレクターに一致する新しいPodが自動的にエンドポイントに追加されます。
|
|
|
|
|
エンドポイントを確認し、IPが最初のステップで作成されたPodと同じであることを確認します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl describe svc my-nginx
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
Name: my-nginx
|
|
|
|
|
Namespace: default
|
|
|
|
|
Labels: run=my-nginx
|
|
|
|
|
Annotations: <none>
|
|
|
|
|
Selector: run=my-nginx
|
|
|
|
|
Type: ClusterIP
|
|
|
|
|
IP: 10.0.162.149
|
|
|
|
|
Port: <unset> 80/TCP
|
|
|
|
|
Endpoints: 10.244.2.5:80,10.244.3.4:80
|
|
|
|
|
Session Affinity: None
|
|
|
|
|
Events: <none>
|
|
|
|
|
```
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get ep my-nginx
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME ENDPOINTS AGE
|
|
|
|
|
my-nginx 10.244.2.5:80,10.244.3.4:80 1m
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
クラスター内の任意のノードから、`<CLUSTER-IP>:<PORT>`でnginx Serviceにcurl接続できるようになりました。
|
|
|
|
|
Service IPは完全に仮想的なもので、ホスト側のネットワークには接続できないことに注意してください。
|
2020-03-27 06:08:22 +00:00
|
|
|
|
この仕組みに興味がある場合は、[サービスプロキシー](/ja/docs/concepts/services-networking/service/#virtual-ips-and-service-proxies)の詳細をお読みください。
|
2020-01-21 04:39:36 +00:00
|
|
|
|
|
|
|
|
|
## Serviceにアクセスする
|
|
|
|
|
|
|
|
|
|
Kubernetesは、環境変数とDNSの2つの主要なService検索モードをサポートしています。
|
|
|
|
|
前者はそのまま使用でき、後者は[CoreDNSクラスタアドオン](http://releases.k8s.io/{{< param "githubbranch" >}}/cluster/addons/dns/coredns)を必要とします。
|
|
|
|
|
{{< note >}}
|
|
|
|
|
サービス環境変数が望ましくない場合(予想されるプログラム変数と衝突する可能性がある、処理する変数が多すぎる、DNSのみを使用するなど)、[Pod仕様](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#pod-v1-core)で`enableServiceLinks`フラグを`false`に設定することでこのモードを無効にできます。
|
|
|
|
|
{{< /note >}}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### 環境変数
|
|
|
|
|
|
|
|
|
|
ノードでPodが実行されると、kubeletはアクティブな各サービスの環境変数のセットを追加します。
|
|
|
|
|
これにより、順序付けの問題が発生します。
|
|
|
|
|
理由を確認するには、実行中のnginx Podの環境を調べます(Pod名は環境によって異なります):
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl exec my-nginx-3800858182-jr4a2 -- printenv | grep SERVICE
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
KUBERNETES_SERVICE_HOST=10.0.0.1
|
|
|
|
|
KUBERNETES_SERVICE_PORT=443
|
|
|
|
|
KUBERNETES_SERVICE_PORT_HTTPS=443
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
サービスに言及がないことに注意してください。これは、サービスの前にレプリカを作成したためです。
|
|
|
|
|
これのもう1つの欠点は、スケジューラーが両方のPodを同じマシンに配置し、サービスが停止した場合にサービス全体がダウンする可能性があることです。
|
|
|
|
|
2つのPodを強制終了し、Deploymentがそれらを再作成するのを待つことで、これを正しい方法で実行できます。
|
|
|
|
|
今回は、サービスはレプリカの「前」に存在します。
|
|
|
|
|
これにより、スケジューラーレベルのサービスがPodに広がり(すべてのノードの容量が等しい場合)、適切な環境変数が提供されます:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl scale deployment my-nginx --replicas=0; kubectl scale deployment my-nginx --replicas=2;
|
|
|
|
|
|
|
|
|
|
kubectl get pods -l run=my-nginx -o wide
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME READY STATUS RESTARTS AGE IP NODE
|
|
|
|
|
my-nginx-3800858182-e9ihh 1/1 Running 0 5s 10.244.2.7 kubernetes-minion-ljyd
|
|
|
|
|
my-nginx-3800858182-j4rm4 1/1 Running 0 5s 10.244.3.8 kubernetes-minion-905m
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Podは強制終了されて再作成されるため、異なる名前が付いていることに気付くでしょう。
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl exec my-nginx-3800858182-e9ihh -- printenv | grep SERVICE
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
KUBERNETES_SERVICE_PORT=443
|
|
|
|
|
MY_NGINX_SERVICE_HOST=10.0.162.149
|
|
|
|
|
KUBERNETES_SERVICE_HOST=10.0.0.1
|
|
|
|
|
MY_NGINX_SERVICE_PORT=80
|
|
|
|
|
KUBERNETES_SERVICE_PORT_HTTPS=443
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### DNS
|
|
|
|
|
|
|
|
|
|
Kubernetesは、DNS名を他のServiceに自動的に割り当てるDNSクラスターアドオンサービスを提供します。
|
|
|
|
|
クラスターで実行されているかどうかを確認できます:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get services kube-dns --namespace=kube-system
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
|
|
|
|
kube-dns ClusterIP 10.0.0.10 <none> 53/UDP,53/TCP 8m
|
|
|
|
|
```
|
|
|
|
|
|
2020-06-11 04:37:27 +00:00
|
|
|
|
このセクションの残りの部分は、寿命の長いIP(my-nginx)を持つServiceと、そのIPに名前を割り当てDNSサーバーがあることを前提にしています。ここではCoreDNSクラスターアドオン(アプリケーション名: `kube-dns`)を使用しているため、標準的なメソッド(`gethostbyname()`など) を使用してクラスター内の任意のポッドからServiceに通信できます。CoreDNSが起動していない場合、[CoreDNS README](https://github.com/coredns/deployment/tree/master/kubernetes)または[Installing CoreDNS](/docs/tasks/administer-cluster/coredns/#installing-coredns)を参照し、有効にする事ができます。curlアプリケーションを実行して、これをテストしてみましょう。
|
2020-01-21 04:39:36 +00:00
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl run curl --image=radial/busyboxplus:curl -i --tty
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
Waiting for pod default/curl-131556218-9fnch to be running, status is Pending, pod ready: false
|
|
|
|
|
Hit enter for command prompt
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
次に、Enterキーを押して`nslookup my-nginx`を実行します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
[ root@curl-131556218-9fnch:/ ]$ nslookup my-nginx
|
|
|
|
|
Server: 10.0.0.10
|
|
|
|
|
Address 1: 10.0.0.10
|
|
|
|
|
|
|
|
|
|
Name: my-nginx
|
|
|
|
|
Address 1: 10.0.162.149
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Serviceを安全にする
|
|
|
|
|
|
|
|
|
|
これまでは、クラスター内からnginxサーバーにアクセスしただけでした。
|
|
|
|
|
サービスをインターネットに公開する前に、通信チャネルが安全であることを確認する必要があります。
|
|
|
|
|
これには、次のものが必要です:
|
|
|
|
|
|
|
|
|
|
* https用の自己署名証明書(既にID証明書を持っている場合を除く)
|
|
|
|
|
* 証明書を使用するように構成されたnginxサーバー
|
|
|
|
|
* Podが証明書にアクセスできるようにする[Secret](/docs/concepts/configuration/secret/)
|
|
|
|
|
|
|
|
|
|
これらはすべて[nginx httpsの例](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/staging/https-nginx/)から取得できます。
|
|
|
|
|
これにはツールをインストールする必要があります。
|
|
|
|
|
これらをインストールしたくない場合は、後で手動の手順に従ってください。つまり:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
make keys KEY=/tmp/nginx.key CERT=/tmp/nginx.crt
|
|
|
|
|
kubectl create secret tls nginxsecret --key /tmp/nginx.key --cert /tmp/nginx.crt
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
secret/nginxsecret created
|
|
|
|
|
```
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get secrets
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME TYPE DATA AGE
|
|
|
|
|
default-token-il9rc kubernetes.io/service-account-token 1 1d
|
2020-06-11 04:37:27 +00:00
|
|
|
|
nginxsecret kubernetes.io/tls 2 1m
|
|
|
|
|
```
|
|
|
|
|
configmapも作成します:
|
|
|
|
|
```shell
|
|
|
|
|
kubectl create configmap nginxconfigmap --from-file=default.conf
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
configmap/nginxconfigmap created
|
|
|
|
|
```
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get configmaps
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME DATA AGE
|
|
|
|
|
nginxconfigmap 1 114s
|
2020-01-21 04:39:36 +00:00
|
|
|
|
```
|
|
|
|
|
以下は、(Windows上など)makeの実行で問題が発生した場合に実行する手動の手順です:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
# 公開秘密鍵ペアを作成します
|
|
|
|
|
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout /d/tmp/nginx.key -out /d/tmp/nginx.crt -subj "/CN=my-nginx/O=my-nginx"
|
|
|
|
|
# キーをbase64エンコードに変換します
|
|
|
|
|
cat /d/tmp/nginx.crt | base64
|
|
|
|
|
cat /d/tmp/nginx.key | base64
|
|
|
|
|
```
|
|
|
|
|
前のコマンドの出力を使用して、次のようにyamlファイルを作成します。
|
|
|
|
|
base64でエンコードされた値はすべて1行である必要があります。
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
apiVersion: "v1"
|
|
|
|
|
kind: "Secret"
|
|
|
|
|
metadata:
|
|
|
|
|
name: "nginxsecret"
|
|
|
|
|
namespace: "default"
|
2020-06-11 04:37:27 +00:00
|
|
|
|
type: kubernetes.io/tls
|
2020-01-21 04:39:36 +00:00
|
|
|
|
data:
|
|
|
|
|
nginx.crt: "LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURIekNDQWdlZ0F3SUJBZ0lKQUp5M3lQK0pzMlpJTUEwR0NTcUdTSWIzRFFFQkJRVUFNQ1l4RVRBUEJnTlYKQkFNVENHNW5hVzU0YzNaak1SRXdEd1lEVlFRS0V3aHVaMmx1ZUhOMll6QWVGdzB4TnpFd01qWXdOekEzTVRKYQpGdzB4T0RFd01qWXdOekEzTVRKYU1DWXhFVEFQQmdOVkJBTVRDRzVuYVc1NGMzWmpNUkV3RHdZRFZRUUtFd2h1CloybHVlSE4yWXpDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFBRGdnRVBBRENDQVFvQ2dnRUJBSjFxSU1SOVdWM0IKMlZIQlRMRmtobDRONXljMEJxYUhIQktMSnJMcy8vdzZhU3hRS29GbHlJSU94NGUrMlN5ajBFcndCLzlYTnBwbQppeW1CL3JkRldkOXg5UWhBQUxCZkVaTmNiV3NsTVFVcnhBZW50VWt1dk1vLzgvMHRpbGhjc3paenJEYVJ4NEo5Ci82UVRtVVI3a0ZTWUpOWTVQZkR3cGc3dlVvaDZmZ1Voam92VG42eHNVR0M2QURVODBpNXFlZWhNeVI1N2lmU2YKNHZpaXdIY3hnL3lZR1JBRS9mRTRqakxCdmdONjc2SU90S01rZXV3R0ljNDFhd05tNnNTSzRqYUNGeGpYSnZaZQp2by9kTlEybHhHWCtKT2l3SEhXbXNhdGp4WTRaNVk3R1ZoK0QrWnYvcW1mMFgvbVY0Rmo1NzV3ajFMWVBocWtsCmdhSXZYRyt4U1FVQ0F3RUFBYU5RTUU0d0hRWURWUjBPQkJZRUZPNG9OWkI3YXc1OUlsYkROMzhIYkduYnhFVjcKTUI4R0ExVWRJd1FZTUJhQUZPNG9OWkI3YXc1OUlsYkROMzhIYkduYnhFVjdNQXdHQTFVZEV3UUZNQU1CQWY4dwpEUVlKS29aSWh2Y05BUUVGQlFBRGdnRUJBRVhTMW9FU0lFaXdyMDhWcVA0K2NwTHI3TW5FMTducDBvMm14alFvCjRGb0RvRjdRZnZqeE04Tzd2TjB0clcxb2pGSW0vWDE4ZnZaL3k4ZzVaWG40Vm8zc3hKVmRBcStNZC9jTStzUGEKNmJjTkNUekZqeFpUV0UrKzE5NS9zb2dmOUZ3VDVDK3U2Q3B5N0M3MTZvUXRUakViV05VdEt4cXI0Nk1OZWNCMApwRFhWZmdWQTRadkR4NFo3S2RiZDY5eXM3OVFHYmg5ZW1PZ05NZFlsSUswSGt0ejF5WU4vbVpmK3FqTkJqbWZjCkNnMnlwbGQ0Wi8rUUNQZjl3SkoybFIrY2FnT0R4elBWcGxNSEcybzgvTHFDdnh6elZPUDUxeXdLZEtxaUMwSVEKQ0I5T2wwWW5scE9UNEh1b2hSUzBPOStlMm9KdFZsNUIyczRpbDlhZ3RTVXFxUlU9Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K"
|
|
|
|
|
nginx.key: "LS0tLS1CRUdJTiBQUklWQVRFIEtFWS0tLS0tCk1JSUV2UUlCQURBTkJna3Foa2lHOXcwQkFRRUZBQVNDQktjd2dnU2pBZ0VBQW9JQkFRQ2RhaURFZlZsZHdkbFIKd1V5eFpJWmVEZWNuTkFhbWh4d1NpeWF5N1AvOE9ta3NVQ3FCWmNpQ0RzZUh2dGtzbzlCSzhBZi9WemFhWm9zcApnZjYzUlZuZmNmVUlRQUN3WHhHVFhHMXJKVEVGSzhRSHA3VkpMcnpLUC9QOUxZcFlYTE0yYzZ3MmtjZUNmZitrCkU1bEVlNUJVbUNUV09UM3c4S1lPNzFLSWVuNEZJWTZMMDUrc2JGQmd1Z0ExUE5JdWFubm9UTWtlZTRuMG4rTDQKb3NCM01ZUDhtQmtRQlAzeE9JNHl3YjREZXUraURyU2pKSHJzQmlIT05Xc0RadXJFaXVJMmdoY1kxeWIyWHI2UAozVFVOcGNSbC9pVG9zQngxcHJHclk4V09HZVdPeGxZZmcvbWIvNnBuOUYvNWxlQlkrZStjSTlTMkQ0YXBKWUdpCkwxeHZzVWtGQWdNQkFBRUNnZ0VBZFhCK0xkbk8ySElOTGo5bWRsb25IUGlHWWVzZ294RGQwci9hQ1Zkank4dlEKTjIwL3FQWkUxek1yall6Ry9kVGhTMmMwc0QxaTBXSjdwR1lGb0xtdXlWTjltY0FXUTM5SjM0VHZaU2FFSWZWNgo5TE1jUHhNTmFsNjRLMFRVbUFQZytGam9QSFlhUUxLOERLOUtnNXNrSE5pOWNzMlY5ckd6VWlVZWtBL0RBUlBTClI3L2ZjUFBacDRuRWVBZmI3WTk1R1llb1p5V21SU3VKdlNyblBESGtUdW1vVlVWdkxMRHRzaG9reUxiTWVtN3oKMmJzVmpwSW1GTHJqbGtmQXlpNHg0WjJrV3YyMFRrdWtsZU1jaVlMbjk4QWxiRi9DSmRLM3QraTRoMTVlR2ZQegpoTnh3bk9QdlVTaDR2Q0o3c2Q5TmtEUGJvS2JneVVHOXBYamZhRGR2UVFLQmdRRFFLM01nUkhkQ1pKNVFqZWFKClFGdXF4cHdnNzhZTjQyL1NwenlUYmtGcVFoQWtyczJxWGx1MDZBRzhrZzIzQkswaHkzaE9zSGgxcXRVK3NHZVAKOWRERHBsUWV0ODZsY2FlR3hoc0V0L1R6cEdtNGFKSm5oNzVVaTVGZk9QTDhPTm1FZ3MxMVRhUldhNzZxelRyMgphRlpjQ2pWV1g0YnRSTHVwSkgrMjZnY0FhUUtCZ1FEQmxVSUUzTnNVOFBBZEYvL25sQVB5VWs1T3lDdWc3dmVyClUycXlrdXFzYnBkSi9hODViT1JhM05IVmpVM25uRGpHVHBWaE9JeXg5TEFrc2RwZEFjVmxvcG9HODhXYk9lMTAKMUdqbnkySmdDK3JVWUZiRGtpUGx1K09IYnRnOXFYcGJMSHBzUVpsMGhucDBYSFNYVm9CMUliQndnMGEyOFVadApCbFBtWmc2d1BRS0JnRHVIUVV2SDZHYTNDVUsxNFdmOFhIcFFnMU16M2VvWTBPQm5iSDRvZUZKZmcraEppSXlnCm9RN3hqWldVR3BIc3AyblRtcHErQWlSNzdyRVhsdlhtOElVU2FsbkNiRGlKY01Pc29RdFBZNS9NczJMRm5LQTQKaENmL0pWb2FtZm1nZEN0ZGtFMXNINE9MR2lJVHdEbTRpb0dWZGIwMllnbzFyb2htNUpLMUI3MkpBb0dBUW01UQpHNDhXOTVhL0w1eSt5dCsyZ3YvUHM2VnBvMjZlTzRNQ3lJazJVem9ZWE9IYnNkODJkaC8xT2sybGdHZlI2K3VuCnc1YytZUXRSTHlhQmd3MUtpbGhFZDBKTWU3cGpUSVpnQWJ0LzVPbnlDak9OVXN2aDJjS2lrQ1Z2dTZsZlBjNkQKckliT2ZIaHhxV0RZK2Q1TGN1YSt2NzJ0RkxhenJsSlBsRzlOZHhrQ2dZRUF5elIzT3UyMDNRVVV6bUlCRkwzZAp4Wm5XZ0JLSEo3TnNxcGFWb2RjL0d5aGVycjFDZzE2MmJaSjJDV2RsZkI0VEdtUjZZdmxTZEFOOFRwUWhFbUtKCnFBLzVzdHdxNWd0WGVLOVJmMWxXK29xNThRNTBxMmk1NVdUTThoSDZhTjlaMTltZ0FGdE5VdGNqQUx2dFYxdEYKWSs4WFJkSHJaRnBIWll2NWkwVW1VbGc9Ci0tLS0tRU5EIFBSSVZBVEUgS0VZLS0tLS0K"
|
|
|
|
|
```
|
|
|
|
|
ファイルを使用してSecretを作成します:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f nginxsecrets.yaml
|
|
|
|
|
kubectl get secrets
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME TYPE DATA AGE
|
|
|
|
|
default-token-il9rc kubernetes.io/service-account-token 1 1d
|
2020-06-11 04:37:27 +00:00
|
|
|
|
nginxsecret kubernetes.io/tls 2 1m
|
2020-01-21 04:39:36 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
次に、nginxレプリカを変更して、シークレットの証明書とServiceを使用してhttpsサーバーを起動し、両方のポート(80と443)を公開します:
|
|
|
|
|
|
|
|
|
|
{{< codenew file="service/networking/nginx-secure-app.yaml" >}}
|
|
|
|
|
|
|
|
|
|
nginx-secure-appマニフェストに関する注目すべき点:
|
|
|
|
|
|
|
|
|
|
- 同じファイルにDeploymentとServiceの両方が含まれています。
|
|
|
|
|
- [nginxサーバー](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/staging/https-nginx/default.conf)はポート80のHTTPトラフィックと443のHTTPSトラフィックを処理し、nginx Serviceは両方のポートを公開します。
|
|
|
|
|
- 各コンテナは`/etc/nginx/ssl`にマウントされたボリュームを介してキーにアクセスできます。
|
|
|
|
|
これは、nginxサーバーが起動する*前に*セットアップされます。
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl delete deployments,svc my-nginx; kubectl create -f ./nginx-secure-app.yaml
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
この時点で、任意のノードからnginxサーバーに到達できます。
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get pods -o yaml | grep -i podip
|
|
|
|
|
podIP: 10.244.3.5
|
|
|
|
|
node $ curl -k https://10.244.3.5
|
|
|
|
|
...
|
|
|
|
|
<h1>Welcome to nginx!</h1>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
最後の手順でcurlに`-k`パラメーターを指定したことに注意してください。
|
|
|
|
|
これは、証明書の生成時にnginxを実行しているPodについて何も知らないためです。
|
|
|
|
|
CNameの不一致を無視するようcurlに指示する必要があります。
|
|
|
|
|
Serviceを作成することにより、証明書で使用されるCNameを、Service検索中にPodで使用される実際のDNS名にリンクしました。
|
|
|
|
|
これをPodからテストしましょう(簡単にするために同じシークレットを再利用しています。PodはServiceにアクセスするためにnginx.crtのみを必要とします):
|
|
|
|
|
|
|
|
|
|
{{< codenew file="service/networking/curlpod.yaml" >}}
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl apply -f ./curlpod.yaml
|
|
|
|
|
kubectl get pods -l app=curlpod
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME READY STATUS RESTARTS AGE
|
|
|
|
|
curl-deployment-1515033274-1410r 1/1 Running 0 1m
|
|
|
|
|
```
|
|
|
|
|
```shell
|
2020-06-11 04:37:27 +00:00
|
|
|
|
kubectl exec curl-deployment-1515033274-1410r -- curl https://my-nginx --cacert /etc/nginx/ssl/tls.crt
|
2020-01-21 04:39:36 +00:00
|
|
|
|
...
|
|
|
|
|
<title>Welcome to nginx!</title>
|
|
|
|
|
...
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Serviceを公開する
|
|
|
|
|
|
|
|
|
|
アプリケーションの一部では、Serviceを外部IPアドレスに公開したい場合があります。
|
|
|
|
|
Kubernetesは、NodePortとLoadBalancerの2つの方法をサポートしています。
|
|
|
|
|
前のセクションで作成したServiceはすでに`NodePort`を使用しているため、ノードにパブリックIPがあれば、nginx HTTPSレプリカはインターネット上のトラフィックを処理する準備ができています。
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get svc my-nginx -o yaml | grep nodePort -C 5
|
|
|
|
|
uid: 07191fb3-f61a-11e5-8ae5-42010af00002
|
|
|
|
|
spec:
|
|
|
|
|
clusterIP: 10.0.162.149
|
|
|
|
|
ports:
|
|
|
|
|
- name: http
|
|
|
|
|
nodePort: 31704
|
|
|
|
|
port: 8080
|
|
|
|
|
protocol: TCP
|
|
|
|
|
targetPort: 80
|
|
|
|
|
- name: https
|
|
|
|
|
nodePort: 32453
|
|
|
|
|
port: 443
|
|
|
|
|
protocol: TCP
|
|
|
|
|
targetPort: 443
|
|
|
|
|
selector:
|
|
|
|
|
run: my-nginx
|
|
|
|
|
```
|
|
|
|
|
```shell
|
|
|
|
|
kubectl get nodes -o yaml | grep ExternalIP -C 1
|
|
|
|
|
- address: 104.197.41.11
|
|
|
|
|
type: ExternalIP
|
|
|
|
|
allocatable:
|
|
|
|
|
--
|
|
|
|
|
- address: 23.251.152.56
|
|
|
|
|
type: ExternalIP
|
|
|
|
|
allocatable:
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
$ curl https://<EXTERNAL-IP>:<NODE-PORT> -k
|
|
|
|
|
...
|
|
|
|
|
<h1>Welcome to nginx!</h1>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
クラウドロードバランサーを使用するようにサービスを再作成しましょう。
|
|
|
|
|
`my-nginx`サービスの`Type`を`NodePort`から`LoadBalancer`に変更するだけです:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl edit svc my-nginx
|
|
|
|
|
kubectl get svc my-nginx
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
|
|
|
|
my-nginx ClusterIP 10.0.162.149 162.222.184.144 80/TCP,81/TCP,82/TCP 21s
|
|
|
|
|
```
|
|
|
|
|
```
|
|
|
|
|
curl https://<EXTERNAL-IP> -k
|
|
|
|
|
...
|
|
|
|
|
<title>Welcome to nginx!</title>
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
`EXTERNAL-IP`列のIPアドレスは、パブリックインターネットで利用可能なものです。
|
|
|
|
|
`CLUSTER-IP`は、クラスター/プライベートクラウドネットワーク内でのみ使用できます。
|
|
|
|
|
|
|
|
|
|
AWSでは、type `LoadBalancer`はIPではなく(長い)ホスト名を使用するELBが作成されます。
|
|
|
|
|
実際、標準の`kubectl get svc`の出力に収まるには長すぎるので、それを確認するには`kubectl describe service my-nginx`を実行する必要があります。
|
|
|
|
|
次のようなものが表示されます:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
kubectl describe service my-nginx
|
|
|
|
|
...
|
|
|
|
|
LoadBalancer Ingress: a320587ffd19711e5a37606cf4a74574-1142138393.us-east-1.elb.amazonaws.com
|
|
|
|
|
...
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
{{% /capture %}}
|
|
|
|
|
|
|
|
|
|
{{% capture whatsnext %}}
|
|
|
|
|
|
2020-06-11 04:37:27 +00:00
|
|
|
|
* 詳細: [Using a Service to Access an Application in a Cluster](/docs/tasks/access-application-cluster/service-access-application-cluster/)
|
|
|
|
|
* 詳細: [Connecting a Front End to a Back End Using a Service](/docs/tasks/access-application-cluster/connecting-frontend-backend/)
|
|
|
|
|
* 詳細: [Creating an External Load Balancer](/docs/tasks/access-application-cluster/create-external-load-balancer/)
|
2020-01-21 04:39:36 +00:00
|
|
|
|
{{% /capture %}}
|