Faça a gestão de pacotes

Esta página explica como gerir pacotes com o Config Sync a partir da Google Cloud consola.

Antes de começar

Implemente um pacote

Depois de registar os seus clusters numa frota e instalar o Config Sync, pode configurar o Config Sync para implementar um pacote num cluster a partir de uma fonte de verdade. Pode implementar o mesmo pacote em vários clusters ou implementar pacotes diferentes em clusters diferentes. Pode editar um pacote após a implementação, exceto algumas definições, como o nome do pacote e o tipo de sincronização. Para mais informações, consulte o artigo Faça a gestão de pacotes.

Para implementar um pacote, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda ao painel de controlo do Config Sync.

    Aceda ao painel de controlo do Config Sync

  2. Clique em Implementar pacote.

  3. Na tabela Selecionar clusters para implementação de pacotes, selecione o cluster ao qual quer implementar um pacote e, de seguida, clique em Continuar.

  4. Selecione Pacote alojado no Git ou Pacote alojado no OCI como o tipo de origem e, de seguida, clique em Continuar.

  5. Na secção Detalhes do pacote, introduza um Nome do pacote, que identifica o objeto RootSync ou RepoSync.

  6. No campo Tipo de sincronização, escolha Sincronização ao nível do cluster ou Sincronização ao nível do espaço de nomes como o tipo de sincronização.

    A sincronização com âmbito de cluster cria um objeto RootSync e a sincronização com âmbito de espaço de nomes cria um objeto RepoSync. Para mais informações sobre estes objetos, consulte o artigo Arquitetura da sincronização de configuração.

  7. Na secção Origem, conclua o seguinte:

    • Para origens alojadas num repositório Git, introduza os seguintes campos:

      1. Introduza o URL do repositório Git que está a usar como fonte de informação como o URL do repositório.
      2. Opcional: atualize o campo Revisão para verificar se não está a usar o HEAD predefinido.
      3. Opcional: atualize o campo Caminho se não quiser sincronizar a partir do repositório raiz.
      4. Opcional: atualize o campo Branch se não estiver a usar a ramificação main predefinida.

    • Para origens alojadas numa imagem OCI, introduza os seguintes campos:

      1. Introduza o URL da imagem OCI que está a usar como fonte de dados fidedignos como imagem.
      2. Introduza o caminho do diretório a partir do qual quer sincronizar, relativo ao diretório raiz, como o Directory.

  8. (Opcional): expanda a secção Definições avançadas para concluir o seguinte:

    1. Selecione um Tipo de autenticação. O Config Sync precisa de acesso só de leitura à sua fonte de informações verdadeiras para ler os ficheiros de configuração na origem e aplicá-los aos seus clusters. A menos que a sua origem não exija autenticação, como um repositório público, certifique-se de que concede ao Config Sync acesso apenas de leitura ao seu repositório Git, imagem OCI ou gráfico Helm (apenas na CLI gcloud). Escolha o mesmo tipo de autenticação que configurou quando instalou o Config Sync:

      • Nenhuma: não use autenticação.
      • SSH: autentique-se através de um par de chaves SSH.
      • Cookiefile: autentique-se através de um cookiefile.
      • Token: autentique-se através de uma chave de acesso ou uma palavra-passe.
      • Google Cloud Repository: use uma conta de serviço Google para aceder a um repositório do Cloud Source Repositories. Selecione esta opção apenas se a Workload Identity Federation para o GKE não estiver ativada no seu cluster.
      • Workload Identity: use uma conta de serviço Google para aceder a um repositório do Cloud Source Repositories.

    2. Introduza um número em segundos para definir o Tempo de espera de sincronização, que determina quanto tempo o Config Sync espera entre tentativas de obtenção da fonte de verdade.

    3. Introduza um URL de proxy Git para o proxy HTTPS a usar quando comunicar com a fonte de informações fidedignas.

    4. Escolha Hierarquia para alterar o Formato de origem.

      O valor predefinido Não estruturado é recomendado na maioria dos casos, uma vez que lhe permite organizar a sua fonte de dados fidedignos da forma que quiser.

  9. Clique em Implementar pacote.

    É feito o redirecionamento para a página Packages do Config Sync. Após alguns minutos, deve ver Sincronizado na coluna Estado da sincronização para o cluster que configurou.

Edite um pacote

Para editar um pacote que já implementou, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda ao separador Packages do Config Sync.

    Aceda a Pacotes

  2. (Opcional): expanda o menu Filtros rápidos e, em seguida, selecione um filtro para ajudar a encontrar o pacote que quer editar.

  3. Expanda o nome do pacote que quer editar e, de seguida, na linha que contém o nome do cluster, clique no menu de contexto e, de seguida, clique em Editar pacote.

  4. Reveja e atualize as definições do pacote que quer alterar.

  5. Clique em Guardar.

Desinstale um pacote

Para desinstalar um pacote da Google Cloud consola, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda ao separador Packages do Config Sync.

    Aceda a Pacotes

  2. (Opcional): expanda o menu Filtros rápidos e, de seguida, selecione um filtro para ajudar a encontrar o pacote que quer desinstalar.

  3. Expanda o nome do pacote que quer desinstalar e, de seguida, na linha que contém o nome do cluster, clique no menu de contexto e, em seguida, clique em Desinstalar pacote.

  4. Na caixa de diálogo de confirmação, selecione se pretende desinstalar apenas o objeto RootSync ou RepoSync, ou desinstalar o RootSync ou o RepoSync e todos os recursos geridos pelo RootSync ou RepoSync.

  5. Escreva a mensagem de confirmação e, de seguida, clique em Desinstalar.

O que se segue?