• 一键部署Choerodon
    • 前置条件
    • 下载安装工具
    • 创建并编辑配置文件
    • 开始部署
    • 后续步骤
    • 常见问题
      • 停留在等待slaver启动过程中/waiting slaver running
      • 提示job已存在
      • 请检查您的域名: xxxx.xx.xx 已正确解析到集群
      • Waiting xxx running

    一键部署Choerodon

    前置条件

    • 成功安装kubernetes集群(1.8.5以上版本)
    • 成功安装helm(2.8.2及以上版本)
    • 每个节点安装nfs-utils(Centos)或nfs-common(Debian/Ubuntu)
    • 安装nfs-provisioner或自有nfs服务
    • 正确解析域名到集群中

    下载安装工具

    如果您的主机没有配置kubernetes连接信息,则您需要到k8s服器中的master执行安装,如果您的主机已经配置了kubernetes的连接信息,并且可以正常执行kubectl命令,您可以在您的主机上执行安装,在安装之前您需要下载安装工具,目前支持Linux及MacOS:

    1. export VERSION=0.19.0
    2. curl -L https://file.choerodon.com.cn/choerodon-install/c7nctl/${VERSION}/c7nctl-${VERSION}-`uname -s`-amd64.tar.gz | tar -xz && cd c7nctl-${VERSION}

    创建并编辑配置文件

    1. vim config.yml

    粘贴以下内容,并将域名修改为你自己的域名

    1. version: 0.19
    2. metadata:
    3. name: install-choerodon
    4. namespace: c7n-system # 指定命名空间安装choerodon
    5. spec:
    6. persistence:
    7. storageClassName: nfs-provisioner
    8. resources:
    9. mysql:
    10. external: false
    11. gitlab:
    12. domain: gitlab.example.choerodon.io
    13. external: false
    14. username: root # gitlab 默认用户名为root,不能修改
    15. schema: http
    16. minio:
    17. domain: minio.example.choerodon.io
    18. schema: http
    19. harbor:
    20. domain: harbor.example.choerodon.io
    21. schema: https
    22. username: admin # harbor 默认用户名为admin,不能修改
    23. chartmuseum:
    24. domain: chart.example.choerodon.io
    25. schema: http
    26. api-gateway:
    27. domain: api.example.choerodon.io
    28. schema: http
    29. notify-service:
    30. domain: notify.example.choerodon.io
    31. schema: ws
    32. devops-service:
    33. domain: devops.example.choerodon.io
    34. schema: ws
    35. choerodon-front:
    36. domain: c7n.example.choerodon.io
    37. schema: http
    38. username: admin # 前端 默认用户名为admin,暂不能修改
    39. password: admin # 前端 默认密码为admin,暂不能修改

    开始部署

    • 在安装过程中,会提示设置某些组件用户名及密码,注意保存
    • 如果安装失败,根据提示操作后,再次执行命令即可
    • 如果安装api-gateway失败请重新执行一次安装命令
    • 执行部署命令,安装过程中如果遇到问题,请先查看本文最后一节关于常见问题的介绍,如果未能解决你的问题,可以到论坛中提问。
    • 更多关于c7nctl的配置请参考此处
    1. ./c7nctl install -c config.yml --no-timeout --version=0.19
    • 参数解释
      参数作用说明
      –no-timeout取消默认任务等待超时微服务安装时需要执行初始化任务,默认超时时长为300秒,添加此参数将超时时长设置为24小时
      –debug输出调试信息

    后续步骤

    • 安装完成后您可以访问您配置的choerodon-front域名,默认用户名和密码都为admin
    • 登录一次Gitlab,第一次登录会提示设置root用户密码,随后会跳转到Choerodon认证,使用admin/admin登录即可,如果使用root/admin用户拉取代码用户名为root,密码为界面设置的密码,其他用户默认密码为password
    • 设置Harbor证书(必须设置)
    • 安装Gitlab-Runner

    常见问题

    停留在等待slaver启动过程中/waiting slaver running
    • 请确认每个节点都安装了nfs-utils
    • nfs服务处于正常运行状态
    提示job已存在

    根据提示执行删除命令后,重新执行安装命令

    请检查您的域名: xxxx.xx.xx 已正确解析到集群

    域名未解析到集群中,如果你刚修改域名解析记录,新修改生效需要等待一段时间,该时间取决于你的DNS服务商,你可以在任意包含ping命令的POD中使用PING命令查看解析是否正确,命令: kubectl exec -ti [POD_NAME] -n [NAMESPACE] ping baidu.com

    Waiting xxx running

    等待前置服务启动,服务启动需要拉取对应镜像,取决于你的网速,一般情况下需要等待1~2分钟,如果长时间未启动,执行命令kubectl get po xxx -n [NAMESPACE]查看对应服务的POD状态。

    • 如果为Pending状态,则执行命令kubectl describe po xxx -n [NAMESPACE]查看Pending的原因。一般为内存、CPU或磁盘不足和网路不通导致。

    • 如果为ContainerCreating,一般为正在拉取镜像,请耐心等待。