LoginSignup
12
8

More than 5 years have passed since last update.

@hrkt

Knativeをminikubeを利用してローカルマシン1台で動かすまで

Last updated at Posted at 2018-07-28

概要

Google Cloud Next '18において、「Knative」が発表されました。
Knativeは、コンテナのオーケストレーションツールであるKubernetes上でアプリを動かす際の手順(ビルド、デプロイ、サービスの管理)を簡略化してくれるツールとのことです。

このエントリでは、ローカルマシン(mac)1台で、Kubernetes環境構築用のツール「Minikube」を利用してKubernetes環境を作り、その上でKnativeを動かすまでについての手順を紹介します。

minikube_dashboard.png
(図：「$ minikube dashboard」を実行して、デプロイ後のサービスを確認したものです)

対象読者

  • Knativeの動かし方を確認したい方
  • Kubernetesが何をしてくれるものかの知識がある方

前提

このエントリでは、2018/7/25時点で利用可能な以下のバージョンを利用しています。

※Minikube上でサービスを動作させるにはそれなりにメモリが必要です。メインメモリが8GBのマシンの場合、Minikube用VMへの割り当てを変更するなどしてお試しください。（筆者はメモリ16GBのマシンでVMに8GBを割り当てて実行しています。）

Minikubeを動かすまで(Kubernetes環境準備)

まずは、Kubernetes環境をローカルマシン内に準備します。
基本的には、Minikubeのサイトに記載されている導入手順通りなのですが、このエントリで利用している方法について簡単に説明します。

ハイパーバイザ

このエントリでは、VirtualBoxを利用します。通常のインストールをした上で、「拡張機能パック」もインストールしています。

Kubernetes-cli

macOSでbrewを使ったインストールです。(brewの導入自体は、brewのタイト上にある通り、上で1行で終了します。)

$ brew install kubernetes-cli

こんな感じでKubernetes-cli 1.11.1が導入されます。

```
==> Downloading https://homebrew.bintray.com/bottles/kubernetes-cli-1.11.1.high_sierra.bottle.tar.gz
################################################################## 100.0%

==> Pouring kubernetes-cli-1.11.1.high_sierra.bottle.tar.gz
==> Caveats
Bash completion has been installed to:
/usr/local/etc/bash_completion.d

zsh completions have been installed to:
/usr/local/share/zsh/site-functions
==> Summary
🍺 /usr/local/Cellar/kubernetes-cli/1.11.1: 196 files, 53.7MB
```

Minikube

リリースページから最新版(エントリ作成時点ではv0.28.2)を取得します。
macOSに対応した、「minikube-darwin-amd64」をダウンロードします。

Knativeのサイトに記載されたオプションでMinikubeを起動します。上と同じく、--vm-driverオプションにはvirtualboxを指定しています。
(うっかり、「minikube」コマンドを単独で実行すると、出来上がったVMがデフォルト設定でメモリが2GBytes程度となり、あとでサービスが増えた時にハマります。)

なお、コマンドが少し長いので筆者はスクリプトにして実行しました。

#!/bin/sh
minikube start --memory=8192 --cpus=4 \
  --kubernetes-version=v1.10.5 \
  --vm-driver=virtualbox \
  --bootstrapper=kubeadm \
  --extra-config=controller-manager.cluster-signing-cert-file="/var/lib/localkube/certs/ca.crt" \
  --extra-config=controller-manager.cluster-signing-key-file="/var/lib/localkube/certs/ca.key" \
  --extra-config=apiserver.admission-control="LimitRanger,NamespaceExists,NamespaceLifecycle,ResourceQuota,ServiceAccount,DefaultStorageClass,MutatingAdmissionWebhook"

Istio

サイトにあるとおりの手順でサービスメッシュのIstioを開始します。

curl -L https://storage.googleapis.com/knative-releases/serving/latest/istio.yaml \
  | sed 's/LoadBalancer/NodePort/' \
  | kubectl apply -f -

サービスが上がるまで待ちます。

状態を確認して、最初はこんなかんじで「ContainerCreating」状態のサービスを含んでいたものが
$ kubectl get pods -n istio-system
NAME                                       READY     STATUS              RESTARTS   AGE
istio-citadel-7bdc7775c7-2nqq6             0/1       ContainerCreating   0          1m
istio-cleanup-old-ca-vgg5g                 0/1       ContainerCreating   0          1m
istio-egressgateway-795fc9b47-fkpw9        1/1       Running             0          1m
istio-ingress-84659cf44c-46rmd             0/1       ContainerCreating   0          1m
istio-ingressgateway-7d89dbf85f-vkgcw      0/1       ContainerCreating   0          1m
istio-mixer-post-install-4jgcb             0/1       Completed           0          1m
istio-pilot-66f4dd866c-f4kpt               0/2       ContainerCreating   0          1m
istio-policy-76c8896799-2lggq              0/2       ContainerCreating   0          1m
istio-sidecar-injector-645c89bc64-hgcbq    0/1       ContainerCreating   0          1m
istio-statsd-prom-bridge-949999c4c-9dzd7   1/1       Running             0          1m
istio-telemetry-6554768879-sz59r           0/2       ContainerCreating   0          1m

状態を確認して、全て「Running」か「Completed」となればOKです。


$ kubectl get pods -n istio-system
NAME READY STATUS RESTARTS AGE
istio-citadel-7bdc7775c7-2nqq6 1/1 Running 0 3m
istio-cleanup-old-ca-vgg5g 0/1 Completed 0 3m
istio-egressgateway-795fc9b47-fkpw9 1/1 Running 0 3m
istio-ingress-84659cf44c-46rmd 1/1 Running 0 3m
istio-ingressgateway-7d89dbf85f-vkgcw 1/1 Running 0 3m
istio-mixer-post-install-4jgcb 0/1 Completed 0 3m
istio-pilot-66f4dd866c-f4kpt 1/2 Running 0 3m
istio-policy-76c8896799-2lggq 2/2 Running 0 3m
istio-sidecar-injector-645c89bc64-hgcbq 1/1 Running 0 3m
istio-statsd-prom-bridge-949999c4c-9dzd7 1/1 Running 0 3m
istio-telemetry-6554768879-sz59r 2/2 Running 0 3m

Knative Serving

Knative Servingを導入します。

サイトの通りに開始します。

curl -L https://storage.googleapis.com/knative-releases/serving/latest/release-lite.yaml \
  | sed 's/LoadBalancer/NodePort/' \
  | kubectl apply -f -

ログはこんな感じ。10秒程度。
$ time curl -L https://storage.googleapis.com/knative-releases/serving/latest/release-lite.yaml \
>   | sed 's/LoadBalancer/NodePort/' \
>   | kubectl apply -f -
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0namespace/knative-build created
clusterrole.rbac.authorization.k8s.io/knative-build-admin created
serviceaccount/build-controller created
clusterrolebinding.rbac.authorization.k8s.io/build-controller-admin created
customresourcedefinition.apiextensions.k8s.io/builds.build.knative.dev created
customresourcedefinition.apiextensions.k8s.io/buildtemplates.build.knative.dev created
service/build-controller created
service/build-webhook created
configmap/config-logging created
deployment.apps/build-controller created
deployment.apps/build-webhook created
namespace/knative-serving created
clusterrole.rbac.authorization.k8s.io/knative-serving-admin created
clusterrole.rbac.authorization.k8s.io/knative-serving-write created
serviceaccount/controller created
serviceaccount/autoscaler created
clusterrolebinding.rbac.authorization.k8s.io/knative-serving-controller-admin created
clusterrolebinding.rbac.authorization.k8s.io/knative-serving-autoscaler-write created
gateway.networking.istio.io/knative-shared-gateway created
service/knative-ingressgateway created
deployment.extensions/knative-ingressgateway created
horizontalpodautoscaler.autoscaling/knative-ingressgateway created
customresourcedefinition.apiextensions.k8s.io/configurations.serving.knative.dev created
customresourcedefinition.apiextensions.k8s.io/revisions.serving.knative.dev created
customresourcedefinition.apiextensions.k8s.io/routes.serving.knative.dev created
customresourcedefinition.apiextensions.k8s.io/services.serving.knative.dev created
service/activator-service created
service/controller created
service/webhook created
deployment.apps/activator created
service/autoscaler created
deployment.apps/autoscaler created
configmap/config-autoscaler created
configmap/config-controller created
configmap/config-domain created
configmap/config-logging created
configmap/config-network created
configmap/config-observability created
deployment.apps/controller created
deployment.apps/webhook created
namespace/monitoring created
configmap/grafana-dashboard-definition-istio created
configmap/grafana-dashboard-definition-mixer created
configmap/grafana-dashboard-definition-pilot created
serviceaccount/kube-state-metrics created
role.rbac.authorization.k8s.io/kube-state-metrics-resizer created
rolebinding.rbac.authorization.k8s.io/kube-state-metrics created
clusterrole.rbac.authorization.k8s.io/kube-state-metrics created
clusterrolebinding.rbac.authorization.k8s.io/kube-state-metrics created
deployment.extensions/kube-state-metrics created
service/kube-state-metrics created
configmap/grafana-dashboard-definition-kubernetes-deployment created
configmap/grafana-dashboard-definition-kubernetes-capacity-planning created
 83  485k   83  403k    0     0   167k      0  0:00:02  0:00:02 --:--:--  167kconfigmap/grafana-dashboard-definition-kubernetes-cluster-health created
configmap/grafana-dashboard-definition-kubernetes-cluster-status created
configmap/grafana-dashboard-definition-kubernetes-control-plane-status created
configmap/grafana-dashboard-definition-kubernetes-resource-requests created
100  485k  100  485k    0     0   160k      0  0:00:03  0:00:03 --:--:--  160k
configmap/grafana-dashboard-definition-kubernetes-nodes created
configmap/grafana-dashboard-definition-kubernetes-pods created
configmap/grafana-dashboard-definition-kubernetes-statefulset created
serviceaccount/node-exporter created
clusterrole.rbac.authorization.k8s.io/node-exporter created
clusterrolebinding.rbac.authorization.k8s.io/node-exporter created
daemonset.extensions/node-exporter created
service/node-exporter created
configmap/scaling-config created
service/fluentd-ds created
configmap/grafana-dashboard-definition-knative-efficiency created
configmap/grafana-dashboard-definition-knative created
configmap/grafana-datasources created
configmap/grafana-dashboards created
service/grafana created
deployment.apps/grafana created
logentry.config.istio.io/requestlog created
fluentd.config.istio.io/requestloghandler created
rule.config.istio.io/requestlogtofluentd created
metric.config.istio.io/revisionrequestcount created
metric.config.istio.io/revisionrequestduration created
metric.config.istio.io/revisionrequestsize created
metric.config.istio.io/revisionresponsesize created
prometheus.config.istio.io/revisionpromhandler created
rule.config.istio.io/revisionpromhttp created
service/kube-controller-manager created
service/prometheus-system-discovery created
configmap/prometheus-scrape-config created
serviceaccount/prometheus-system created
role.rbac.authorization.k8s.io/prometheus-system created
role.rbac.authorization.k8s.io/prometheus-system created
role.rbac.authorization.k8s.io/prometheus-system created
role.rbac.authorization.k8s.io/prometheus-system created
clusterrole.rbac.authorization.k8s.io/prometheus-system created
rolebinding.rbac.authorization.k8s.io/prometheus-system created
rolebinding.rbac.authorization.k8s.io/prometheus-system created
rolebinding.rbac.authorization.k8s.io/prometheus-system created
rolebinding.rbac.authorization.k8s.io/prometheus-system created
clusterrolebinding.rbac.authorization.k8s.io/prometheus-system created
service/prometheus-system-np created
statefulset.apps/prometheus-system created
logentry.config.istio.io/requestlog unchanged
fluentd.config.istio.io/requestloghandler unchanged
rule.config.istio.io/requestlogtofluentd unchanged
metric.config.istio.io/revisionrequestcount unchanged
metric.config.istio.io/revisionrequestduration unchanged
metric.config.istio.io/revisionrequestsize unchanged
metric.config.istio.io/revisionresponsesize unchanged
prometheus.config.istio.io/revisionpromhandler unchanged
rule.config.istio.io/revisionpromhttp unchanged

real    0m7.227s
user    0m0.604s
sys 0m0.154s

動作を確認します。

$ kubectl get pods -n knative-serving
NAME                          READY     STATUS    RESTARTS   AGE
activator-5f78d674df-b7f2v    2/2       Running   4          17m
autoscaler-5787568ff8-5mg79   2/2       Running   4          17m
controller-c8dd5d467-8hnhx    1/1       Running   2          17m
webhook-78f58769cb-m5s7z      1/1       Running   2          17m

Knative上でサンプルを動かす

Knativeのサイト上のガイド「Getting Started with Knative App Deployment」の例を動かしてみます。

services.yamlの準備

このようなファイルを準備します。ガイドに示された、「gcr.io/knative-samples/helloworld-go」のイメージを使っています。

apiVersion: serving.knative.dev/v1alpha1 # Current version of Knative
kind: Service
metadata:
  name: helloworld-go # The name of the app
  namespace: default # The namespace the app will use
spec:
  runLatest:
    configuration:
      revisionTemplate:
        spec:
          container:
            image: gcr.io/knative-samples/helloworld-go # The URL to the image of the app
            env:
            - name: TARGET # The environment variable printed out by the sample app
              value: "Go Sample v1"

動かします。(ここの簡単さがKnativeのいいところ)

$ kubectl apply -f service.yaml
service.serving.knative.dev/helloworld-go created

この1行で、Knativeは下記を担当してくれます。
- このアプリの普遍なリビジョンを作る
- route, ingress, load balancerを作る
- podのスケールアップ/ダウン

動作状況を確認します。

$ 
NAME                     TYPE       CLUSTER-IP      EXTERNAL-IP   PORT(S)                                      AGE
knative-ingressgateway   NodePort   10.104.55.123   <none>        80:32380/TCP,443:32390/TCP,32400:32400/TCP   25m

サービスのURLを調べて、

$ kubectl get services.serving.knative.dev helloworld-go  -o=custom-columns=NAME:.metadata.name,DOMAIN:.status.domain
NAME            DOMAIN
helloworld-go   helloworld-go.default.example.com

Knativeのサイトにある方法で接続先IPアドレスを調べて、

$ echo $(minikube ip):$(kubectl get svc knative-ingressgateway -n istio-system -o 'jsonpath={.spec.ports[?(@.port==80)].nodePort}')

192.168.99.101:32380

このアドレスを変数にセットして、

export IP_ADDRESS=192.168.99.100:32380

接続してみます。

$ curl -H "Host: ${HOST_URL}" http://${IP_ADDRESS}
Hello World: Go Sample v1!

Goプログラムからの出力が確認できました。

services.yamlの内容を少し書き換えて

              value: "Go Sample version2"

サービスを登録し直すと、

$ kubectl apply -f service.yaml
service.serving.knative.dev/helloworld-go configured

少し経つと、サービスの環境変数が新しい内容となり、コンソールの出力変わることが確認できます。

$ curl -H "Host: ${HOST_URL}" http://${IP_ADDRESS}
Hello World: Go Sample version2

$ minikube dashboard

を実行すると、サービスのデプロイの様子をWebのコンソールで確認できます(本エントリ冒頭の図)。

まとめ

本エントリでは、Knativeをローカルマシン1台で試す方法について説明しました。
Minikubeを使うと、マシン一台でお手軽に試すことができるのでおすすめです。

12
8
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
12
8