您正在查看 KubeSphere 版本的文档:v3.0.0

KubeSphere v3.0.0 版本的文档已不再维护。您现在看到的版本来自于一份静态的快照。如需查阅最新文档,请点击 最新版本

构建和部署 Go 工程

准备工作

创建 Docker Hub 访问令牌 (Token)

  1. 登录 Docker Hub 并在右上角的菜单中选择 Account Settings

    DockerHub 设置

  2. 在左侧点击 Security,然后点击 New Access Token

    DockerHub 创建令牌

  3. 输入令牌名称,点击 Create

    DockerHub 令牌创建完成

  4. 点击 Copy and Close 并务必保存该访问令牌。

    复制 DockerHub 令牌

创建凭证

您需要在 KubeSphere 中为已创建的访问令牌创建凭证,以便流水线能够向 Docker Hub 推送镜像。此外,您还需要创建 kubeconfig 凭证,用于访问 Kubernetes 集群。

  1. project-regular 身份登录 KubeSphere Web 控制台,转到您的 DevOps 工程,在凭证页面点击创建

    创建 DockerHub ID

  2. 在弹出对话框中,设置凭证 ID,稍后会用于 Jenkinsfile 中,类型选择帐户凭证用户名输入您的 Docker Hub 帐户名称,token / 密码中输入刚刚创建的访问令牌。操作完成后,点击确定

    创建 Docker 凭证

    提示

    有关如何创建凭证的更多信息,请参见凭证管理
  3. 再次点击创建类型选择 kubeconfig。KubeSphere 会自动填充 Content 字段,即当前用户帐户的 kubeconfig。设置凭证 ID,然后点击确定

    创建 kubeconfig

创建流水线

创建完上述凭证后,您可以按照以下步骤使用示例 Jenkinsfile 创建流水线。

  1. 要创建流水线,请在流水线页面点击创建

    创建流水线

  2. 在弹出窗口中设置名称,然后点击下一步

    设置流水线名称

  3. 在本教程中,您可以为所有字段使用默认值。在高级设置页面,直接点击创建

    创建流水线-2

编辑 Jenkinsfile

  1. 在流水线列表中,点击该流水线进入其详情页面。点击编辑 Jenkinsfile 定义一个 Jenkinsfile,流水线会基于它来运行。

    编辑 jenkinsfile

  2. 将以下所有内容复制并粘贴到弹出窗口中,用作流水线的示例 Jenkinsfile。您必须将 DOCKERHUB_USERNAMEDOCKERHUB_CREDENTIALKUBECONFIG_CREDENTIAL_IDPROJECT_NAME 的值替换成您自己的值。操作完成后,点击确定

    pipeline {  
      agent {
        node {
          label 'maven'
        }
      }
    
      environment {
        // the address of your harbor registry
        REGISTRY = 'docker.io'
        // your docker hub username
        DOCKERHUB_USERNAME = 'yuswift'
        // docker image name
        APP_NAME = 'devops-go-sample'
        // ‘dockerhubid’ is the credential id you created in KubeSphere for docker access token
        DOCKERHUB_CREDENTIAL = credentials('dockerhubid')
        //the kubeconfig credential id you created in KubeSphere
        KUBECONFIG_CREDENTIAL_ID = 'go'
        // the name of the project you created in KubeSphere, not the DevOps project name
        PROJECT_NAME = 'devops-go'
      }
    
      stages {
        stage('docker login') {
          steps{
            container ('maven') {
              sh 'echo $DOCKERHUB_CREDENTIAL_PSW  | docker login -u $DOCKERHUB_CREDENTIAL_USR --password-stdin'
                }
              }  
            }
    
        stage('build & push') {
          steps {
            container ('maven') {
              sh 'git clone https://github.com/yuswift/devops-go-sample.git'
              sh 'cd devops-go-sample && docker build -t $REGISTRY/$DOCKERHUB_USERNAME/$APP_NAME .'
              sh 'docker push $REGISTRY/$DOCKERHUB_USERNAME/$APP_NAME'
              }
            }
          }
        stage ('deploy app') {
          steps {
            container('maven') {
              kubernetesDeploy(configs: 'devops-go-sample/manifest/deploy.yaml', kubeconfigId: "$KUBECONFIG_CREDENTIAL_ID")
              }
            }
          }
        }
      }
    

    备注

    如果您的流水线成功运行,将会推送镜像至 Docker Hub。如果您使用 Harbor,则无法通过 Jenkins 凭证使用环境变量将参数传送到 docker login -u。这是因为每个 Harbor Robot 帐户的用户名都包含一个 $ 字符,当用于环境变量时,Jenkins 会将其转换为 $$了解更多信息

运行流水线

  1. Jenkinsfile 设置完成后,您可以在仪表板上查看图形面板。点击运行来运行流水线。

    运行流水线

  2. 活动选项卡中,您可以查看流水线的状态。稍等片刻,流水线便会成功运行。

    流水线成功运行

验证结果

  1. 如果流水线成功运行,则会在 Jenkinsfile 中指定的项目中创建一个部署 (Deployment)

    查看部署

  2. 查看镜像是否已推送至 Docker Hub,如下所示:

    Docker 镜像-1

    Docker 镜像-2