Build and Deploy a Go Project
Prerequisites
- You need to enable the KubeSphere DevOps System.
- You need to have a Docker Hub account.
- You need to create a workspace, a DevOps project, a project, and a user (
project-regular
). This account needs to be invited to the DevOps project and the project for deploying your workload with the roleoperator
. For more information, see Create Workspaces, Projects, Users and Roles.
Create a Docker Hub Access Token
Log in to Docker Hub, click your account in the upper-right corner, and select Account Settings from the menu.
Click Security in the left navigation pane and then click New Access Token.
In the displayed dialog box, enter a token name (
go-project-token
) and click Create.Click Copy and Close and make sure you save the access token.
Create Credentials
You need to create credentials in KubeSphere for the access token created so that the pipeline can interact with Docker Hub for imaging pushing. Besides, you also create kubeconfig credentials for the access to the Kubernetes cluster.
Log in to the web console of KubeSphere as
project-regular
. In your DevOps project, go to Credentials under DevOps Project Settings and then click Create on the Credentials page.In the displayed dialog box, set a Name, which is used later in the Jenkinsfile, and select Username and password for Type. Enter your Docker Hub account name for Username and the access token just created for Password/Token. When you finish, click OK.
Tip
For more information about how to create credentials, see Credential Management.Click Create again and select kubeconfig for Type. Note that KubeSphere automatically populates the Content field, which is the kubeconfig of the current user account. Set a Name and click OK.
Create a Pipeline
With the above credentials ready, you can create a pipeline using an example Jenkinsfile as below.
To create a pipeline, click Create on the Pipelines page.
Set a name in the displayed dialog box and click Next.
In this tutorial, you can use default values for all the fields. On the Advanced Settings tab, click Create.
Edit the Jenkinsfile
In the pipeline list, click the pipeline name to go to its details page. Click Edit Jenkinsfile to define a Jenkinsfile and your pipeline runs based on it.
Copy and paste all the content below to the displayed dialog box as an example Jenkinsfile for your pipeline. You must replace the value of
DOCKERHUB_USERNAME
,DOCKERHUB_CREDENTIAL
,KUBECONFIG_CREDENTIAL_ID
, andPROJECT_NAME
with yours. When you finish, click OK.
pipeline {
agent {
label 'go'
}
environment {
// the address of your Docker Hub registry
REGISTRY = 'docker.io'
// your Docker Hub username
DOCKERHUB_USERNAME = 'Docker Hub Username'
// Docker image name
APP_NAME = 'devops-go-sample'
// 'dockerhubid' is the credentials ID you created in KubeSphere with Docker Hub Access Token
DOCKERHUB_CREDENTIAL = credentials('dockerhubid')
// the kubeconfig credentials 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 ('go') {
sh 'echo $DOCKERHUB_CREDENTIAL_PSW | docker login -u $DOCKERHUB_CREDENTIAL_USR --password-stdin'
}
}
}
stage('build & push') {
steps {
container ('go') {
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 ('go') {
withCredentials([
kubeconfigFile(
credentialsId: env.KUBECONFIG_CREDENTIAL_ID,
variable: 'KUBECONFIG')
]) {
sh 'envsubst < devops-go-sample/manifest/deploy.yaml | kubectl apply -f -'
}
}
}
}
}
}
Note
docker login -u
via the Jenkins credential with environment variables. This is because every Harbor robot account username contains a $
character, which will be converted to $$
by Jenkins when used by environment variables. Learn more.Run the Pipeline
After you finish the Jenkinsfile, you can see graphical panels are displayed on the dashboard. Click Run to run the pipeline.
In Run Records, you can see the status of the pipeline. It may take a while before it successfully runs.
Verify Results
A Deployment is created in the project specified in the Jenkinsfile if the pipeline runs successfully.
Check the image that is pushed to Docker Hub.
Feedback
Was this page Helpful?
Receive the latest news, articles and updates from KubeSphere
Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.