Gerenciar pacotes

Nesta página, explicamos como gerenciar pacotes com o Config Sync no console do Google Cloud.

Um pacote é um conjunto de manifestos de objetos de recursos do Kubernetes gerenciados em uma fonte de verdade e sincronizados com um cluster pelo Config Sync. Cada definição de pacote está contida em um objeto RootSync ou RepoSync no cluster. Para mais informações detalhadas sobre os objetos RootSync e RepoSync, consulte Arquitetura do Config Sync.

Antes de começar

Implantar um pacote

Depois de registrar os clusters em uma frota e instalar o Config Sync, é possível configurar o Config Sync para implantar um pacote em um cluster de uma fonte de verdade. É possível implantar o mesmo pacote em vários clusters ou implantar pacotes diferentes em clusters diferentes. É possível editar um pacote após a implantação, exceto algumas configurações, como o nome do pacote e o tipo de sincronização. Para mais informações, consulte Gerenciar pacotes.

Para implantar um pacote, siga estas etapas:

  1. No console do Google Cloud, acesse o painel do Config Sync.

    Acessar o painel do Config Sync

  2. Clique em Implantar pacote.

  3. Na tabela Selecionar clusters para implantação do pacote, selecione o cluster em que quer implantar um pacote e clique em Continuar.

  4. Selecione Pacote hospedado no Git ou Pacote hospedado na OCI como tipo de origem e clique em Continuar.

  5. Na seção Package details, insira um Package name, que identifica o objeto RootSync ou RepoSync.

  6. No campo Sync type, escolha Cluster scoped sync ou Namespace scoped sync como o tipo de sincronização.

    A sincronização com escopo de Cluster cria um objeto RootSync, e a sincronização com escopo de Namespace cria um objeto RepoSync. Para mais informações sobre esses objetos, consulte Arquitetura do Config Sync.

  7. Na seção Origem, faça o seguinte:

    • Para fontes hospedadas em um repositório Git, insira os seguintes campos:

      1. Digite o URL do repositório Git que você está usando como fonte de verdade como o URL do repositório.
      2. Opcional: atualize o campo Revisão para verificar se você não está usando o HEAD padrão.
      3. Opcional: atualize o campo Path se você não quiser sincronizar a partir do repositório raiz.
      4. Opcional: atualize o campo Ramificação se você não estiver usando a ramificação main padrão.

    • Para fontes hospedadas em uma imagem OCI, insira os seguintes campos:

      1. Insira o URL da imagem OCI que você está usando como fonte de verdade como a Imagem.
      2. Insira o caminho do diretório de onde sincronizar, relativo ao diretório raiz, como o Diretório.

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

    1. Selecione um Tipo de autenticação. O Config Sync precisa de acesso somente leitura à sua fonte de verdade para ler os arquivos de configuração na origem e aplicá-los aos clusters. A menos que a origem não exija autenticação, como um repositório público, conceda acesso somente leitura ao Config Sync ao repositório Git, imagem OCI ou gráfico Helm (somente na gcloud CLI). Escolha o mesmo tipo de autenticação que você configurou ao instalar o Config Sync:

      • Nenhum: não usar autenticação.
      • SSH: faça a autenticação usando um par de chaves SSH.
      • Cookiefile: faça a autenticação usando um cookiefile.
      • Token: faça a autenticação usando um token de acesso ou uma senha.
      • Google Cloud Repository: use uma conta de serviço do Google para acessar um repositório do Cloud Source Repositories. Selecione esta opção somente se a Federação de Identidade da Carga de Trabalho para GKE não estiver ativada no cluster.
      • Identidade da carga de trabalho: use uma conta de serviço do Google para acessar um repositório do Cloud Source Repositories.

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

    3. Insira um URL de proxy Git para o proxy HTTPS a ser usado ao se comunicar com a fonte da verdade.

    4. Escolha Hierarquia para mudar o Formato de origem.

      O valor padrão Não estruturado é recomendado na maioria dos casos, porque permite organizar a fonte de verdade como você quiser.

  9. Clique em Implantar pacote.

    Você será redirecionado para a página Pacotes do Config Sync. Após alguns minutos, a mensagem Sincronizado vai aparecer na coluna Status da sincronização do cluster configurado.

Editar um pacote

Para editar um pacote que você já implantou, siga estas etapas:

  1. No console do Google Cloud, acesse a guia Pacotes do Config Sync.

    Acessar "Pacotes"

  2. (Opcional): abra o menu Filtros rápidos e selecione um filtro para ajudar a encontrar o pacote que você quer editar.

  3. Abra o nome do pacote que você quer editar e, na linha que contém o nome do cluster, clique no menu de contexto e em Edit package.

  4. Revise e atualize as configurações do pacote que você quer mudar.

  5. Clique em Salvar.

Desinstalar um pacote

Para desinstalar um pacote no console do Google Cloud, siga estas etapas:

  1. No console do Google Cloud, acesse a guia Pacotes do Config Sync.

    Acessar "Pacotes"

  2. (Opcional): abra o menu Filtros rápidos e selecione um filtro para ajudar a encontrar o pacote que você quer desinstalar.

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

  4. Na caixa de diálogo de confirmação, selecione se você quer desinstalar apenas o objeto RootSync ou RepoSync ou desinstalar o RootSync ou RepoSync e todos os recursos gerenciados por ele.

  5. Digite a mensagem de confirmação e clique em Desinstalar.

A seguir