Gerenciando configurações do GitOps

Crie uma configuração para implantar aplicativos do seu repositório GitHub ou GitLab nos seus clusters.

Satellite O Config atualiza a configuração atual a cada 5 minutos, independentemente de ter sido bem-sucedido ou não. Se for feita qualquer atualização na configuração do cluster, por exemplo, usando kubectl edit, o Satellite Config atualizará a configuração para que ela corresponda ao que está definido no repositório GitHub ou GitLab.

Criando configurações do Satellite

Com o Satellite Config, você cria uma configuração para especificar quais recursos do Kubernetes você deseja implementar em um grupo de clusters Red Hat OpenShift on IBM Cloud que executam em seu local do Satellite ou na IBM Cloud.

Antes de Iniciar

Criando um segredo para usar um repositório privado

Para se conectar a repositórios privados, é necessário criar e aplicar um token de acesso pessoal do Git aos seus clusters.

  1. Crie um token Github ou Gitlab.

  2. Codifique o token em base64.

    printf "TOKEN_FROM_GITHUB_OR_GITLAB" | base64

  3. Para cada cluster que você deseja usar, faça login no cluster e crie um segredo nomeado razee-git no espaço de nomes razeedeploy aplicando o seguinte arquivo YAML:

    apiVersion: v1
data:
  token: [BASE64_ENCODED_TOKEN_FROM_GITHUB_OR_GITLAB]
kind: Secret
metadata:
  name: razee-git
  namespace: razeedeploy
type: Opaque

    Você pode ter apenas um segredo entre os repositórios GitHub e GitLab.

Criando configurações do Satellite por meio do console

Para implementar um app de exemplo, consulte Implementando Kubernetes recursos para clusters com Satellite Config.

Para criar a sua configuração personalizada, use a UI Satellite e siga estes passos.

  1. Faça login no Satellite Config UI com suas credenciais IBM Cloud.

  2. Clique para Criar configuração.

  3. Na página Procurar modelos, selecione o modelo GitOps.

  4. Na página Configuração, especifique seu nome de configuração e provedor.

    Campo Descrição
    Nome da configuração Insira o nome da configuração “ Satellite ”.
    Provedor Selecione o provedor remoto para as configurações do Satellite, que armazena as definições dos recursos Kubernetes a serem implantados em seus clusters. As opções são GitHub e GitLab.
  1. Na página “Assinatura”, especifique o endereço do seu repositório URL, a visibilidade do repositório, Git os detalhes da referência, o caminho para o seu arquivo ou diretório e o grupo de cluster no qual deseja fazer a implantação.
    Campo Descrição
    Repositório URL Insira o repositório remoto a ser usado para esta assinatura do Satellite.
    visibilidade do repositório Selecione se este repositório é público ou privado.
    Tipo de referência do Git Selecione o tipo de referência do Git a ser usado para esta assinatura do Satellite. Os valores válidos são Branch, Tag, Commit e Release.
    Nome do branch/tag/commit/versão Insira a referência Git a ser usada para esta assinatura Satellite.
    Caminho Insira o caminho para os arquivos no repositório remoto a serem usados para esta assinatura do Satellite.
    Nome da assinatura Digite um nome para sua assinatura do “ Satellite ”. O nome branch/tag/commit/release é preenchido automaticamente como o nome da assinatura por padrão.
    Grupo de clusters Insira o nome do grupo de clusters no qual você deseja implantar seus recursos do Kubernetes.
  1. Na página Resumo, confirme se as informações exibidas estão corretas e, em seguida, clique em Concluir.

Criando configurações do Satellite por meio da CLI

Use o plug-in da CLI para os comandos do Satellite para criar uma configuração.

Para criar a configuração:

  1. Configure seus clusters para usar com o Satellite Config. Essa configuração inclui a criação de um grupo de clusters e a concessão de acesso ao Satellite Config aos seus clusters.

  2. Crie uma configuração do Satellite.

    ibmcloud sat config create --name CONFIG_NAME [--provider <provider>] [-q]
    Entendendo os componentes deste comando
    Componente Descrição
    --name <config_name> Digite o nome da configuração do Satellite.
    --provider <provider> Insira o provedor remoto para as configurações Satellite, que armazena as definições de recursos Kubernetes para serem implementados em seus clusters. Os valores válidos são github e gitlab.
    -q Não mostrar a mensagem do dia ou os lembretes de atualização.

    Saída de exemplo

    Creating configuration...
OK
Configuration <config_name> was successfully created with ID 116fffde-0835-467c-8987-67dd42e4e393.

  3. Crie uma Assinatura para o seu grupo de cluster para a configuração Satellite.

    ibmcloud sat subscription create --name <subscription_name> --group <cluster_group_name> --config <config_name_or_ID> --repository <repository_value> --gitref-type <type_value> --gitref <gitref_value> --path <path_value> [-q]
    Entendendo os componentes deste comando
    Componente Descrição
    --name <subscription_name> Insira um nome para a sua assinatura do Satellite.
    --group <cluster_group_name> Insira o nome do grupo de clusters no qual você deseja implementar seus recursos do Kubernetes.
    --config <config_name_or_ID> Insira o nome ou o ID da configuração do Satellite criado anteriormente.
    --repository <repository_value> Insira o repositório remoto para usar para esta assinatura Satellite.
    --gitref-type <type_value> Digite o tipo de Git ref para usar para esta assinatura Satellite. Os valores válidos são branch, commit, tag e release.
    --gitref <gitref_value> Insira o ref Git para usar para esta assinatura Satellite.
    --path <path_value> Insira o caminho para os arquivos no repositório remoto para usar para esta assinatura Satellite.
    -q Não mostrar a mensagem do dia ou os lembretes de atualização.

    Saída de exemplo

    Creating subscription...
OK
Subscription <subscription_name> was successfully created with ID f6114bd5-f71e-4335-b034-ca45fa3cab81.

  4. Siga a etapa 5 em Criando configurações do Satellite por meio do console para revisar o status de lançamento de seus recursos do Kubernetes.

Atualização da sua configuração Satellite

Para atualizar sua configuração, é possível fazer atualizações no nível de subscrição As ações que você precisa levar depende de que tipo de atualizações você quer fazer.

  • Para implementar uma nova versão de seu aplicativo no mesmo grupo de clusters, atualize os arquivos no repositório GitHub ou GitLab definido em sua configuração e confirme as mudanças.
  • Para alterar quaisquer propriedades do seu repositório de origem, é possível editar a assinatura e atualizar os campos com novos detalhes.
  • Para associar vários repositórios com a mesma configuração, adicionar um novo repositório de origem ou adicionar novos detalhes de ref do Git para o mesmo repositório de origem, você pode criar novas assinaturas. Clique em Criar assinatura e preencha os detalhes de sua nova assinatura. Se desejar criar uma nova assinatura que tenha apenas alguns detalhes alterados, será possível usar a opção Duplicar para preencher automaticamente todos os campos com propriedades da assinatura existente e modificar os campos que deseja alterar.
  • Para excluir uma assinatura, utilize a opção Remover..

Atualizando sua assinatura pelo console

Use o console do Satellite para atualizar sua configuração.

  1. Faça login no Satellite Config UI com suas credenciais IBM Cloud.

  2. Selecione a configuração que você deseja atualizar.

  3. Clique no menu overflow na linha da assinatura para atualizar e selecionar Editar.

  4. Na página Editar assinatura, faça as alterações e clique em Salvar.

Atualizando seu Satellite Config com a CLI

Use o plug-in da CLI para os comandos do Satellite para atualizar sua configuração. Se você deseja atualizar sua configuração para usar um novo arquivo, você pode atualizar sua assinatura para apontar para o novo arquivo.

  1. Atualize o Assinatura para que seu grupo de cluster use a configuração nova Satellite no repositório remoto. Você só precisa especificar os parâmetros que deseja alterar.

    ibmcloud sat subscription update --subscription <subscription_name> [--name <new_subscription_name>] [--group <cluster_group_name>] [--repository <repository_value>] [--gitref-type <type_value>] [--gitref <gitref_value>] [--path <path_value>] [-f] [-q]
    Entendendo os componentes deste comando
    Componente Descrição
    --subscription <subscription_value> Digite o nome ou o ID da assinatura a ser atualizada.
    --name <new_subscription_name> Digite o novo nome da assinatura.
    --group <cluster_group_name> Insira o nome do grupo de clusters no qual você deseja implementar seus recursos do Kubernetes.
    --repository <repository_value> Insira o repositório remoto para usar para esta assinatura Satellite.
    --gitref-type <type_value> Digite o tipo de Git ref para usar para esta assinatura Satellite. Os valores válidos são branch, commit, tag e release.
    --gitref <gitref_value> Insira o ref Git para usar para esta assinatura Satellite.
    --path <path_value> Insira o caminho para os arquivos no repositório remoto para usar para esta assinatura Satellite.
    -f Force o comando a ser executado sem prompts do usuário.
    -q Não mostrar a mensagem do dia ou os lembretes de atualização.

    Saída de exemplo

    Are you sure you want to update the subscription <subscription_name>? [y/N]y
OK
Subscription f6114bd5-f71e-4335-b034-ca45fa3cab81 was successfully updated.

  2. Siga a etapa 5 em Criando configurações do Satellite por meio do console para revisar o status de lançamento de seus recursos do Kubernetes.