Definir e usar um tipo de segmentação personalizada

Preparar a configuração do Skaffold e o manifesto do aplicativo

O Cloud Deploy usa o Skaffold para oferecer os detalhes sobre o que implantar e como implantar no seu destino.

Neste guia de início rápido, você vai criar um arquivo skaffold.yaml, que define ações personalizadas que representam as operações de renderização e implantação do tipo de segmentação.

As ações personalizadas fornecidas neste guia de início rápido não implantam realmente de qualquer aplicativo para o ambiente de execução. As ações de renderização e implantação fazem o upload do arquivo de resultados no Cloud Storage para cumprir o contrato de destino personalizado entre o Cloud Deploy e a renderização e implantação definidas pelo usuário.

1. Abra uma janela de terminal.

2. Crie um novo diretório e navegue até ele.

   mkdir custom-target-quickstart
   cd custom-target-quickstart
   

3. Crie um arquivo chamado skaffold.yaml com o seguinte conteúdo:

   apiVersion: skaffold/v4beta7
   kind: Config
   customActions:
   - name: custom-render
     containers:
     - name: render
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:66e2681aa3099b4e517e4cdcdefff8f2aa45d305007124ccdc09686f6712d018
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo "Sample manifest rendered content" > manifest.txt
           gcloud storage cp manifest.txt $CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt
           echo {\"resultStatus\": \"SUCCEEDED\", \"manifestFile\": \"$CLOUD_DEPLOY_OUTPUT_GCS_PATH/manifest.txt\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   - name: custom-deploy
     containers:
     - name: deploy
       image: gcr.io/google.com/cloudsdktool/google-cloud-cli@sha256:66e2681aa3099b4e517e4cdcdefff8f2aa45d305007124ccdc09686f6712d018
       command: ['/bin/bash']
       args:
         - '-c'
         - |-
           echo {\"resultStatus\": \"SUCCEEDED\"} > results.json
           gcloud storage cp results.json $CLOUD_DEPLOY_OUTPUT_GCS_PATH/results.json
   

   Esse arquivo inclui a estrofe customActions:, que define uma ação de renderização personalizada e uma ação de implantação personalizada. Cada uma dessas ações personalizadas faz referência a um imagem de contêiner a ser executada e comandos a serem executados nesse contêiner.

   Consulte a referência do skaffold.yaml. para mais informações sobre esse arquivo de configuração.

Crie o pipeline de entrega, o tipo de destino personalizado e o destino

É possível definir o pipeline de entrega, o tipo de destino personalizado e o destino em um arquivo ou em arquivos separados. Neste guia de início rápido, você criará um único arquivo com todos os três.

1. No diretório custom-target-quickstart, crie um novo arquivo, clouddeploy.yaml, com o seguinte conteúdo:

   apiVersion: deploy.cloud.google.com/v1
   kind: DeliveryPipeline
   metadata:
     name: custom-targets-pipeline
   serialPipeline:
     stages:
     - targetId: sample-env
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: Target
   metadata:
     name: sample-env
   customTarget:
     customTargetType: basic-custom-target
   ---
   
   apiVersion: deploy.cloud.google.com/v1
   kind: CustomTargetType
   metadata:
     name: basic-custom-target
   customActions:
     renderAction: custom-render
     deployAction: custom-deploy
   

2. Registre o pipeline e os destinos com o serviço do Cloud Deploy:

   gcloud deploy apply --file=clouddeploy.yaml --region=us-central1 --project=PROJECT_ID
   

   Agora você tem um pipeline de entrega com um destino. Esse é seu objetivo usando o tipo de destino personalizado, e o pipeline não implanta um aplicativo em um no ambiente de execução.

3. Confirme o pipeline e os destinos:

   No console do Google Cloud, acesse a página do Cloud Deploy Página Pipelines de entrega para exibir a lista de entregas disponíveis pipelines de dados.

   Abrir a página "Pipelines de entrega"

   O pipeline de entrega que você acabou de criar é mostrado, com um destino listado em na coluna Destinos.

   

Criar uma versão

Uma versão é o recurso central do Cloud Deploy que representa mudanças que estão sendo implantadas. O pipeline de entrega define o ciclo de vida dessa versão. Consulte Arquitetura de serviço do Cloud Deploy para detalhes sobre esse ciclo de vida.

Execute o comando a seguir no diretório custom-target-quickstart para criar um recurso release que represente a ação personalizada a ser implantada:

gcloud deploy releases create test-release-001 \
  --project=PROJECT_ID \
  --region=us-central1 \
  --delivery-pipeline=custom-targets-pipeline

Assim como acontece com todas as versões (a menos que incluam --disable-initial-rollout), O Cloud Deploy cria automaticamente um rollout também. E todas as fases disso lançamento são executados, incluindo a renderização e a implantação.

Conferir os resultados no console do Google Cloud

Após alguns minutos, a implantação será concluída. Nesse caso, como os dois ações personalizadas são comandos para reproduzir strings em um arquivo e fazer upload dele para Cloud Storage, nada é implantado em nenhum ambiente de execução de destino.

No entanto, você pode ver o arquivo e as strings dele:

1. No console do Google Cloud, acesse a página do Cloud Deploy Página Pipelines de entrega para exibir o pipeline de entrega (custom-targets-pipeline).

   Abrir a página "Pipelines de entrega"

2. Clique no nome do pipeline de entrega (custom-targets-pipeline).

   A visualização do pipeline mostra o status de implantação do aplicativo. Como há apenas uma fase no pipeline, a visualização mostra apenas um nó.

   

   E sua versão é listada na guia Versões em Detalhes do pipeline de entrega.

3. Clique no nome da versão.

   A página Detalhes da versão é exibida.

4. Clique na guia Artefatos.

5. Em Artefatos de destino, clique no link VER ARTEFATOS.

   O arquivo de manifesto renderizado é mostrado. Neste caso, o arquivo é a saída a ação de renderização personalizada definida na configuração skaffold.yaml que contém a string "Exemplo de conteúdo renderizado de manifesto".

   

6. Encontre os buckets do Cloud Storage criados por esta versão.

   Abrir a página "Procurar" do Cloud Storage

   A página Buckets é exibida, mostrando dois buckets criados para este lançamento. Um bucket contém o arquivo de configuração do pipeline de entrega e o skaffold.yaml renderizado. O outro inclui o arquivo de saída que nosso está configurada para criação.

7. Clique no bucket que tem um nome que começa com us-central1.deploy-artifacts...

   

8. Clique na pasta com nome que começa com custom-targets-pipeline- e clique na pasta test-release-001.

9. Clique na pasta que tem o nome do lançamento, que deve ser test-release-001-to-sample-env-0001:

10. Clique na pasta mostrada, que é um UUID, e na pasta custom-output.

11. Clique em results.json e, em seguida, clique no URL com hiperlink na caixa URL.

    Esse arquivo contém a string que você configurou como saída do custom-deploy, na sua skaffold.yaml: