• Operator SDK
    • 安装 Operator SDK
    • 创建项目
    • 参考

    Operator SDK

    Operator SDK 由 CoreOS 开源,它是用于构建 Kubernetes 原生应用的 SDK,它提供更高级别的 API、抽象和项目脚手架。在阅读本文前请先确认您已经了解 Operator是什么。

    使用 Kubernetes 中原生的对象来部署和管理复杂的应用程序不是那么容易,尤其是要管理整个应用的生命周期、组件的扩缩容,我们之前通常是编写各种脚本,通过调用 Kubernetes 的命令行工具来管理 Kubernetes 上的应用。现在可以通过 CRD(CustomResourceDefinition)来自定义这些复杂操作,通过将运维的知识封装在自定义 API 里来减轻运维人员的负担。同时我们还可以像操作 Kubernetes 的原生资源对象一样,使用 kubectl 来操作 CRD。

    下面我们将安装和试用一下 Operator SDK。

    安装 Operator SDK

    1. $ mkdir -p $GOPATH/src/github.com/operator-framework
    2. $ cd $GOPATH/src/github.com/operator-framework/operator-sdk
    3. $ dep ensure
    4. Create kubernetes-operator-sdk-tutorial/cmd/kubernetes-operator-sdk-tutorial/main.go
    5. Create kubernetes-operator-sdk-tutorial/config/config.yaml
    6. Create kubernetes-operator-sdk-tutorial/deploy/rbac.yaml
    7. Create kubernetes-operator-sdk-tutorial/deploy/cr.yaml
    8. Create kubernetes-operator-sdk-tutorial/pkg/apis/jimmysong/v1alpha1/doc.go
    9. Create kubernetes-operator-sdk-tutorial/pkg/apis/jimmysong/v1alpha1/register.go
    10. Create kubernetes-operator-sdk-tutorial/pkg/apis/jimmysong/v1alpha1/types.go
    11. Create kubernetes-operator-sdk-tutorial/pkg/stub/handler.go
    12. Create kubernetes-operator-sdk-tutorial/tmp/build/build.sh
    13. Create kubernetes-operator-sdk-tutorial/tmp/build/docker_build.sh
    14. Create kubernetes-operator-sdk-tutorial/tmp/build/Dockerfile
    15. Create kubernetes-operator-sdk-tutorial/tmp/codegen/boilerplate.go.txt
    16. Create kubernetes-operator-sdk-tutorial/tmp/codegen/update-generated.sh
    17. Create kubernetes-operator-sdk-tutorial/Gopkg.toml
    18. Create kubernetes-operator-sdk-tutorial/Gopkg.lock
    19. Run dep ensure ...
    20. Root project is "github.com/rootsongjc/kubernetes-operator-sdk-tutorial"
    21. 3 transitively valid internal packages
    22. 12 external packages imported from 4 projects
    23. (0) select (root)
    24. (1) ? attempt k8s.io/api with 1 pkgs; at least 1 versions to try
    25. (1) try k8s.io/api@kubernetes-1.9.3
    26. (1) select k8s.io/api@kubernetes-1.9.3 w/1 pkgs
    27. (2) ? attempt k8s.io/apimachinery with 4 pkgs; at least 1 versions to try
    28. (2) try k8s.io/apimachinery@kubernetes-1.9.3
    29. (2) select k8s.io/apimachinery@kubernetes-1.9.3 w/22 pkgs
    30. ...
    31. $ go install github.com/operator-framework/operator-sdk/commands/operator-sdk

    该过程需要几分钟,请耐心等待。确认 $GOPATH/bin/operator-sdk 文件位于您的 $PATH 目录下。

    创建项目

    1. $ cd $GOPATH/src/github.com/<your-github-repo>/
    2. $ operator-sdk new <operator-project-name> --api-version=<your-api-group>/<version> --kind=<custom-resource-kind>
    3. $ cd <operator-project-name>
    • operator-project-name:创建的项目的名称
    • your-api-group:Kubernetes 自定义 API 的组名,一般用域名如 jimmysong.io
    • version:Kubernetes 自定义资源的 API 版本
    • custom-resource-kind:CRD 的名称
    1. operator-sdk new kubernetes-operator-sdk-tutorial --api-version=jimmysong.io/v1alpha1 --kind=operator-sdk

    参考

    • A complete guide to Kubernetes Operator SDK