Como integrar com o Jenkins

Alfa

Este produto ou recurso é coberto pelos Termos de ofertas pré-disponibilidade geral dos Termos de Serviço do Google Cloud Platform. Os produtos e recursos pré-disponibilidade geral podem ter suporte limitado, e as mudanças realizadas podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições das fases de lançamento.

Nesta página, orientamos você na configuração do Jenkins para armazenar pacotes Maven criados em um repositório do Artifact Registry.

O gerenciamento de pacotes está em Alfa. Ele só está disponível para usuários Alfa e pode não incluir todos os recursos disponíveis para o gerenciamento de contêineres. Para se inscrever no Alfa, preencha o formulário de inscrição.

Antes de começar

1. Se não existir um repositório de destino, crie um novo repositório.

Como configurar o acesso ao seu repositório

1. Crie uma conta de serviço dedicada para que o Jenkins use com o Artifact Registry.

   Execute o seguinte comando para criar uma conta de serviço chamada jenkins-sa:

   gcloud iam service-accounts create jenkins-sa
   

   Isso cria uma conta de serviço chamada [e-mail], em que PROJECT é o ID do seu projeto.

2. No projeto que contém o repositório, conceda o papel Gravador de artefatos do Cloud Build à conta de serviço do Jenkins criada. É possível conceder o papel para todos os repositórios no projeto ou conceder o papel para os repositórios específicos que a conta de serviço precisa acessar.

   Para detalhes sobre permissões e concessão de acesso por papel, consulte Como configurar o controle de acesso.

Como configurar um cluster do GKE

Ao configurar um novo cluster ou pool de nós do Google Kubernetes Engine, use a conta de serviço criada para o Jenkins usar.

Console

Para criar um cluster usando o Console do Cloud, siga estas etapas:

1. Acesse o menu do Artifact Registry no Console do Cloud.

   Acesse o menu do Artifact Registry

2. Clique em Criar cluster.

3. Configure o cluster como quiser. Não clique em Criar ainda.

4. Clique em Mais opções no pool de nós padrão.

5. Na seção Segurança, selecione a conta de serviço do Jenkins criada.

   Observação: se você quiser usar a conta de serviço padrão do Compute Engine, selecione Definir acesso para cada API na seção Escopo de acesso. Na lista suspensa Leitura/gravação do Cloud Platform, selecione Ativado.

6. Clique em Salvar para sair da sobreposição.

7. Clique em Criar.

gcloud

Use um dos seguintes comandos para criar o cluster com a conta de serviço do Jenkins. Nos comandos, PROJECT é o ID do projeto.

Para criar um cluster com a conta de serviço, execute o comando.

gcloud container clusters create example-cluster --service-account=[e-mail]

Para criar um pool de nós em um cluster atual:

gcloud container node-pools create example-pool --service-account=[e-mail]

Consulte a documentação gcloud container clusters create para detalhes sobre o comando.

Observação: se você quiser usar a conta de serviço padrão do Compute Engine, omita a opção --service-account e adicione --scopes cloud-platform para aplicar o escopo de acesso do Cloud Platform.

Como instalar o Jenkins no GKE

1. Siga o tutorial para configurar o Jenkins no GKE. Use o cluster que você criou na seção anterior.

2. No Jenkins, atualize o plug-in do GKE para a versão mais recente. Clique em Gerenciar o Jenkins > Gerenciar Plug-ins > Atualizações.

Como configurar um projeto Maven

1. Bifurque o projeto Maven de amostra no repositório do GitHub da documentação do Jenkins.

2. Clone o repositório bifurcado.

   git clone [e-mail]:USER_NAME/simple-java-maven-app.git
   

3. Configure um novo pipeline na interface do Jenkins.

   1. Clique em Novo item.
   2. Selecione Pipeline.
   3. Defina um nome para o pipeline e clique em OK.

4. Na guia Geral, configure as seguintes opções na seção Pipeline:

   • Selecione Script de pipeline no SCM.
   • Na lista suspensa do SCM, selecione Git e especifique o URL e as credenciais para se conectar ao seu repositório GitHub.

   

5. Clique em Save.

Como configurar a conexão ao repositório

Configure o Jenkins com o repositório e as credenciais para se conectar ao repositório.

1. Adicione seu repositório ao Maven pom.xml. Use o seguinte comando para imprimir um snippet a ser adicionado.

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

   Onde

   • PROJECT é o ID do projeto; Se essa sinalização for omitida, o projeto atual ou padrão será usado.
   • REPOSITORY é o ID do repositório. Se você tiver configurado um repositório do Artifact Registry padrão, ele será usado quando essa sinalização for omitida no comando.
   • LOCATION é o local regional ou multirregional do repositório.

2. Crie um arquivo YAML como o modelo de pod para os agentes do Jenkins.

   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. Modifique o arquivo Jenkinsfile.

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

Como iniciar uma compilação

1. Envie as alterações feitas para o projeto do GitHub.

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

2. Na interface do Jenkins, inicie uma nova compilação do aplicativo no projeto Maven de amostra.

Quando a compilação é concluída com sucesso, os artefatos são adicionados ao repositório Maven do Artifact Registry que você criou.

Execute o comando a seguir para listar os pacotes no repositório:

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

A saída será assim:

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