将 Docker Compose 文件转换为 Kubernetes 资源

    更多信息请参考 Kompose 官网 http://kompose.io。

    你必须拥有一个 Kubernetes 的集群，同时你的 Kubernetes 集群必须带有 kubectl 命令行工具。 建议在至少有两个节点的集群上运行本教程，且这些节点不作为控制平面主机。 如果你还没有集群，你可以通过 Minikube 构建一个你自己的集群，或者你可以使用下面任意一个 Kubernetes 工具构建：

    要获知版本信息，请输入 kubectl version.

    安装 Kompose

    我们有很多种方式安装 Kompose。首选方式是从最新的 GitHub 发布页面下载二进制文件。

    Kompose 通过 GitHub 发布，发布周期为三星期。 你可以在 上看到所有当前版本。

    或者，你可以下载 tar 包。

    用 go get 命令从主分支拉取最新的开发变更的方法安装 Kompose。

    1. go get -u github.com/kubernetes/kompose

    Kompose 位于 CentOS 代码仓库。 如果你还没有安装并启用 EPEL 代码仓库， 请运行命令 sudo yum install epel-release。

    如果你的系统中已经启用了 ， 你就可以像安装其他软件包一样安装 Kompose。

    1. sudo yum -y install kompose

    Kompose 位于 Fedora 24、25 和 26 的代码仓库。你可以像安装其他软件包一样安装 Kompose。

    1. sudo dnf -y install kompose

    在 macOS 上你可以通过 Homebrew 安装 Kompose 的最新版本：

    1. brew install kompose

    使用 Kompose

    只需几步，我们就把你从 Docker Compose 带到 Kubernetes。 你只需要一个现有的 docker-compose.yml 文件。

    1. 进入 docker-compose.yml 文件所在的目录。如果没有，请使用下面这个进行测试。

      1. version: "2"
      3. services:
      5.   redis-master:
      6.     image: registry.k8s.io/redis:e2e
      7.     ports:
      8.       - "6379"
      10.   redis-slave:
      11.     image: gcr.io/google_samples/gb-redisslave:v3
      12.     ports:
      13.       - "6379"
      14.     environment:
      15.       - GET_HOSTS_FROM=dns
      17.   frontend:
      18.     image: gcr.io/google-samples/gb-frontend:v4
      19.     ports:
      20.       - "80:80"
      21.     environment:
      22.       - GET_HOSTS_FROM=dns
      23.     labels:
      24.       kompose.service.type: LoadBalancer

    2. 要将 docker-compose.yml 转换为 kubectl 可用的文件，请运行 kompose convert 命令进行转换，然后运行 kubectl apply -f <output file> 进行创建。

      1. kompose convert

      输出类似于：

      1. INFO Kubernetes file "frontend-tcp-service.yaml" created 
      2. INFO Kubernetes file "redis-master-service.yaml" created 
      3. INFO Kubernetes file "redis-slave-service.yaml" created 
      4. INFO Kubernetes file "frontend-deployment.yaml" created 
      5. INFO Kubernetes file "redis-master-deployment.yaml" created 
      6. INFO Kubernetes file "redis-slave-deployment.yaml" created
      1. kubectl apply -f frontend-tcp-service.yaml,redis-master-service.yaml,redis-slave-service.yaml,frontend-deployment.yaml,redis-master-deployment.yaml,redis-slave-deployment.yaml

      输出类似于：

      1. service/frontend-tcp created
      2. service/redis-master created
      3. service/redis-slave created
      4. deployment.apps/frontend created
      5. deployment.apps/redis-master created
      6. deployment.apps/redis-slave created

      你部署的应用在 Kubernetes 中运行起来了。

    3. 如果你在开发过程中使用 minikube，请执行：

      1. minikube service frontend

      否则，我们要查看一下你的服务使用了什么 IP！

      1. kubectl describe svc frontend
      1. Name:                     frontend-tcp
      2. Namespace:                default
      3. Annotations:              kompose.cmd: kompose convert
      4.                           kompose.service.type: LoadBalancer
      5.                           kompose.version: 1.26.0 (40646f47)
      6. Selector:                 io.kompose.service=frontend
      7. Type:                     LoadBalancer
      8. IP Family Policy:         SingleStack
      9. IP Families:              IPv4
      10. IP:                       10.43.67.174
      11. IPs:                      10.43.67.174
      12. Port:                     80  80/TCP
      13. TargetPort:               80/TCP
      14. NodePort:                 80  31254/TCP
      15. Endpoints:                10.42.0.25:80
      16. Session Affinity:         None
      17. External Traffic Policy:  Cluster
      18. Events:
      19.   Type    Reason                Age   From                Message
      21.   Normal  EnsuringLoadBalancer  62s   service-controller  Ensuring load balancer
      22.   Normal  AppliedDaemonSet      62s   service-controller  Applied LoadBalancer DaemonSet kube-system/svclb-frontend-tcp-9362d276

      如果你使用的是云驱动，你的 IP 将在 LoadBalancer Ingress 字段给出。

    4. 清理。

      你完成示例应用 Deployment 的测试之后，只需在 Shell 中运行以下命令，就能删除用过的资源。

      1. kubectl delete -f frontend-tcp-service.yaml,redis-master-service.yaml,redis-slave-service.yaml,frontend-deployment.yaml,redis-master-deployment.yaml,redis-slave-deployment.yaml

    Kompose 支持两种驱动：OpenShift 和 Kubernetes。 你可以通过全局选项 --provider 选择驱动。如果没有指定， 会将 Kubernetes 作为默认驱动。

    kompose convert

    Kompose 支持将 V1、V2 和 V3 版本的 Docker Compose 文件转换为 Kubernetes 和 OpenShift 资源对象。

    1. kompose --file docker-voting.yml convert
    1. WARN Unsupported key networks - ignoring
    2. WARN Unsupported key build - ignoring
    3. INFO Kubernetes file "worker-svc.yaml" created
    4. INFO Kubernetes file "db-svc.yaml" created
    5. INFO Kubernetes file "redis-svc.yaml" created
    6. INFO Kubernetes file "result-svc.yaml" created
    7. INFO Kubernetes file "vote-svc.yaml" created
    8. INFO Kubernetes file "redis-deployment.yaml" created
    9. INFO Kubernetes file "result-deployment.yaml" created
    10. INFO Kubernetes file "vote-deployment.yaml" created
    11. INFO Kubernetes file "worker-deployment.yaml" created
    12. INFO Kubernetes file "db-deployment.yaml" created
    1. ls
    1. db-deployment.yaml  docker-compose.yml         docker-gitlab.yml  redis-deployment.yaml  result-deployment.yaml  vote-deployment.yaml  worker-deployment.yaml
    2. db-svc.yaml         docker-voting.yml          redis-svc.yaml     result-svc.yaml        vote-svc.yaml           worker-svc.yaml

    你也可以同时提供多个 docker-compose 文件进行转换：

    1. kompose -f docker-compose.yml -f docker-guestbook.yml convert
    1. INFO Kubernetes file "frontend-service.yaml" created         
    2. INFO Kubernetes file "mlbparks-service.yaml" created         
    3. INFO Kubernetes file "mongodb-service.yaml" created          
    4. INFO Kubernetes file "redis-master-service.yaml" created     
    5. INFO Kubernetes file "redis-slave-service.yaml" created      
    6. INFO Kubernetes file "frontend-deployment.yaml" created      
    7. INFO Kubernetes file "mlbparks-deployment.yaml" created      
    8. INFO Kubernetes file "mongodb-deployment.yaml" created       
    9. INFO Kubernetes file "mongodb-claim0-persistentvolumeclaim.yaml" created
    10. INFO Kubernetes file "redis-master-deployment.yaml" created  
    11. INFO Kubernetes file "redis-slave-deployment.yaml" created
    1. ls
    1. mlbparks-deployment.yaml  mongodb-service.yaml                       redis-slave-service.jsonmlbparks-service.yaml  
    2. frontend-deployment.yaml  mongodb-claim0-persistentvolumeclaim.yaml  redis-master-service.yaml
    3. frontend-service.yaml     mongodb-deployment.yaml                    redis-slave-deployment.yaml
    4. redis-master-deployment.yaml

    当提供多个 docker-compose 文件时，配置将会合并。任何通用的配置都将被后续文件覆盖。

    1. kompose --provider openshift --file docker-voting.yml convert
    1. WARN [worker] Service cannot be created because of missing port.
    2. INFO OpenShift file "vote-service.yaml" created             
    3. INFO OpenShift file "db-service.yaml" created               
    4. INFO OpenShift file "redis-service.yaml" created            
    5. INFO OpenShift file "result-service.yaml" created           
    6. INFO OpenShift file "vote-imagestream.yaml" created         
    7. INFO OpenShift file "worker-deploymentconfig.yaml" created  
    8. INFO OpenShift file "worker-imagestream.yaml" created       
    9. INFO OpenShift file "db-deploymentconfig.yaml" created      
    10. INFO OpenShift file "db-imagestream.yaml" created           
    11. INFO OpenShift file "redis-deploymentconfig.yaml" created   
    12. INFO OpenShift file "redis-imagestream.yaml" created        
    13. INFO OpenShift file "result-deploymentconfig.yaml" created  
    14. INFO OpenShift file "result-imagestream.yaml" created

    kompose 还支持为服务中的构建指令创建 buildconfig。 默认情况下，它使用当前 git 分支的 remote 仓库作为源仓库，使用当前分支作为构建的源分支。 你可以分别使用 --build-repo 和 --build-branch 选项指定不同的源仓库和分支。

    1. kompose --provider openshift --file buildconfig/docker-compose.yml convert

    说明：

    如果使用 oc create -f 手动推送 OpenShift 工件，则需要确保在构建配置工件之前推送 imagestream 工件，以解决 OpenShift 的这个问题： 。

    其他转换方式

    默认的 kompose 转换会生成 yaml 格式的 Kubernetes 和 Service 对象。 你可以选择通过 -j 参数生成 json 格式的对象。 你也可以替换生成 对象、 DaemonSet 或 Chart。

    1. kompose convert -j
    1. INFO Kubernetes file "redis-svc.json" created
    2. INFO Kubernetes file "web-svc.json" created
    3. INFO Kubernetes file "redis-deployment.json" created
    4. INFO Kubernetes file "web-deployment.json" created

    *-deployment.json 文件中包含 Deployment 对象。

    1. kompose convert --replication-controller
    1. INFO Kubernetes file "redis-svc.yaml" created
    2. INFO Kubernetes file "web-svc.yaml" created
    3. INFO Kubernetes file "redis-replicationcontroller.yaml" created
    4. INFO Kubernetes file "web-replicationcontroller.yaml" created

    *-replicationcontroller.yaml 文件包含 Replication Controller 对象。 如果你想指定副本数（默认为 1），可以使用 --replicas 参数： 

    1. kompose convert --daemon-set
    1. INFO Kubernetes file "redis-svc.yaml" created
    2. INFO Kubernetes file "web-svc.yaml" created
    3. INFO Kubernetes file "redis-daemonset.yaml" created
    4. INFO Kubernetes file "web-daemonset.yaml" created

    如果你想生成 Helm 可用的 Chart， 只需简单的执行下面的命令：

    1. kompose convert -c
    1. INFO Kubernetes file "web-svc.yaml" created
    2. INFO Kubernetes file "redis-svc.yaml" created
    3. INFO Kubernetes file "web-deployment.yaml" created
    4. INFO Kubernetes file "redis-deployment.yaml" created
    5. chart created in "./docker-compose/"
    1. tree docker-compose/
    1. docker-compose
    2. ├── Chart.yaml
    3. ├── README.md
    4. └── templates
    5.     ├── redis-deployment.yaml
    6.     ├── redis-svc.yaml
    7.     ├── web-deployment.yaml
    8.     └── web-svc.yaml

    这个 Chart 结构旨在为构建 Helm Chart 提供框架。

    kompose 支持 docker-compose.yml 文件中用于 Kompose 的标签， 以便在转换时明确定义 Service 的行为。

    • kompose.service.type 定义要创建的 Service 类型。例如：

      1. version: "2"
      2. services:
      3.   nginx:
      4.     image: nginx
      5.     dockerfile: foobar
      6.     build: ./foobar
      7.     cap_add:
      8.       - ALL
      9.     container_name: foobar
      10.     labels:
      11.       kompose.service.type: nodeport

    • kompose.service.expose 定义是否允许从集群外部访问 Service。 如果该值被设置为 “true”，提供程序将自动设置端点， 对于任何其他值，该值将被设置为主机名。 如果在 Service 中定义了多个端口，则选择第一个端口作为公开端口。

      • 如果使用 Kubernetes 驱动，会有一个 Ingress 资源被创建，并且假定已经配置了相应的 Ingress 控制器。
      • 如果使用 OpenShift 驱动，则会有一个 route 被创建。

      例如：

      1. version: "2"
      2. services:
      3.   web:
      4.     image: tuna/docker-counter23
      5.     ports:
      6.      - "5000:5000"
      7.     links:
      8.      - redis
      9.     labels:
      10.       kompose.service.expose: "counter.example.com"
      11.   redis:
      12.     image: redis:3.0
      13.     ports:

    当前支持的选项有:

    说明：

    kompose.service.type 标签应该只用 ports 来定义，否则 kompose 会失败。

    重启

    如果你想创建没有控制器的普通 Pod，可以使用 docker-compose 的 restart 结构来指定这一行为。请参考下表了解 restart 的不同参数。

    docker-compose restart创建的对象Pod restartPolicy
    “”控制器对象Always
    always控制器对象Always
    on-failurePodOnFailure
    noPodNever

    说明：

    控制器对象可以是 deployment 或 replicationcontroller。

    例如，pival Service 将在这里变成 Pod。这个容器计算 pi 的取值。

    如果 Docker Compose 文件中为服务声明了卷，Deployment（Kubernetes）或 DeploymentConfig（OpenShift）策略会从 “RollingUpdate”（默认）变为 “Recreate”。 这样做的目的是为了避免服务的多个实例同时访问卷。

    如果 Docker Compose 文件中的服务名包含 _（例如 web_service）， 那么将会被替换为 -，服务也相应的会重命名（例如 web-service）。 Kompose 这样做的原因是 “Kubernetes” 不允许对象名称中包含 _。

    请注意，更改服务名称可能会破坏一些 docker-compose 文件。

    Docker Compose 版本

    Kompose 支持的 Docker Compose 版本包括：1、2 和 3。 对 2.1 和 3.2 版本的支持还有限，因为它们还在实验阶段。