Integrating with Jenkins

This page guides you through configuring Jenkins to store built Maven packages in an Artifact Registry repository.

Before you begin

If the target repository does not exist, create a new repository.

Configuring access to your repository

1. Create a dedicated service account for Jenkins to use with Artifact Registry.

   Run the following command to create a service account named jenkins-sa:

   gcloud iam service-accounts create jenkins-sa
   

   This creates a service account named jenkins-sa@PROJECT.iam.gserviceaccount.com, where PROJECT is your project ID.

2. In the project that contains the repository, grant the Artifact Registry Writer role to the Jenkins service account that you created. You can either grant the role for all repositories in the project or you can grant the role for the specific repositories that service account needs to access.

   For details on permissions and granting access by role, see Configuring access control.

Setting up a GKE cluster

When you set up a new Google Kubernetes Engine cluster or node pool, use the service account that you created for Jenkins to use.

gcloud container clusters create example-cluster --service-account=jenkins-sa@PROJECT.iam.gserviceaccount.com

gcloud container node-pools create example-pool --service-account=jenkins-sa@PROJECT.iam.gserviceaccount.com

Setting up Jenkins on GKE

1. Follow the tutorial for setting up Jenkins on GKE. Use the cluster that you created in the previous section.

2. In Jenkins, update the GKE plugin to the latest version. Click Manage Jenkins > Manage Plugins > Updates.

Set up a Maven project

1. Fork the sample Maven project in the Jenkins documentation GitHub repository.

2. Clone the forked repository.

   git clone git@github.com:USER_NAME/simple-java-maven-app.git
   

3. Set up a new pipeline in the Jenkins interface.

   1. Click New Item.
   2. Select Pipeline.
   3. Set a name for the pipeline and click OK.

4. On the General tab, configure the following options in the Pipeline section:

   • Select Pipeline script from SCM.
   • In the SCM drop-down list, select Git and then specify the URL and credentials to connect to your GitHub repository.

   

5. Click Save.

Configuring the connection to the repository

Configure Jenkins with the repository and credentials to connect to the repository.

1. Add your repository to the Maven pom.xml. Use the following command to print a snippet to add.

   gcloud artifacts print-settings mvn [--project=PROJECT] \
   [--repository=REPOSITORY] [--location=LOCATION]
   

   Where

   • PROJECT is the project ID. If this flag is omitted, the current or default project is used.
   • REPOSITORY is the ID of the repository. If you configured a default Artifact Registry repository, it is used when this flag is omitted from the command.
   • LOCATION is the regional or multi-regional location for the repository.

2. Create a YAML file as the pod template for Jenkins agents.

   mkdir jenkins
   cat > jenkins/maven-pod.yaml << EOF
   apiVersion: v1
   kind: Pod
   spec:
     containers:
     - name: maven
       image: maven:3.3.9-jdk-8-alpine
       command: ['cat']
       tty: true
   EOF
   

3. Modify the file Jenkinsfile.

   pipeline {
       agent none
       stages {
           stage('Deploy') {
               steps {
                    agent {
                        kubernetes {
                            label 'mavenpod'
                            yamlFile 'jenkins/maven-pod.yaml'
                          }
                      }
                      container('maven') {
                      sh "mvn -B clean deploy"
                    }
               }
           }
       }
   }
   

Starting a build

1. Push the changes you made to GitHub project.

   git add . && git commit -m "Configure my Jenkins pipeline" && git push
   

2. In the Jenkins interface, start a new build for the application in your sample Maven project.

When the build completes successfully, the artifacts are added to the Artifact Registry Java package repository that you created.

Run the following command to list packages in the repository:

gcloud artifacts packages list --repository=mvn-jenkins --location=LOCATION

The output looks similar to the following example:

Listing items under project {YOUR_PROJECT}, repository mvn-jenkins.

PACKAGE                   CREATE_TIME          UPDATE_TIME
com.mycompany.app:my-app  2019-06-25T17:09:44  2019-06-25T17:09:44