Objetivos

Neste tutorial, você aprenderá a criar uma cadeia de ferramentas aberta usando o Continuous Delivery para implantar seu aplicativo em vários clusters. Você também aprende como as cadeias de ferramentas são implementadas no serviço Continuous Delivery e como implementar um app web simples usando um modelo Continuous Delivery-somente o template da cadeia de ferramentas.

Com Satellite Config, você cria uma configuração que especifica quais recursos do Kubernetes você deseja implementar em um grupo de clusters. Em seguida, configure um pipeline Continuous Delivery para implementar esses recursos em um grupo de clusters sempre que uma mudança é feita na configuração.

A cadeia de ferramentas que é usada neste tutorial implementa práticas padrão do DevOps em torno de recursos de entrega contínua, gerenciando suas implementações em locais do Satellite. Depois de criar os clusters e associá-los a um grupo de clusters do Satellite, você pode criar uma cadeia de ferramentas para alterar o código-fonte da sua implantação e enviar a alteração para o repositório GitHub. Quando você empurra mudanças em seu repo, o pipeline de entrega baseado em Tekton implementa automaticamente o código para seus clusters.

Público

Este tutorial destina-se a administradores que estejam utilizando as cadeias de ferramentas do Continuous Delivery e o Satellite Config para implantar recursos pela primeira vez.

Pré-requisitos

Antes de iniciar este tutorial, certifique-se de que você tenha os seguintes recursos à disposição.

• Um IBM Cloud conta. Dependendo de seu tipo de conta da IBM Cloud, o acesso a determinados recursos pode ser limitado. Dependendo dos limites do seu plano de conta, certos recursos exigidos por algumas estratégias de implantação podem não estar disponíveis. Para obter mais informações sobre as contas do IBM Cloud, consulte “Como configurar sua conta do IBM Cloud ” e “Como fazer o upgrade da sua conta ”.

• Um cluster Satellite ou um cluster Red Hat® OpenShift® em IBM Cloud que é registrado com o seu local Satellite.

Se você não tiver um cluster do Satellite, poderá registrar um cluster do Red Hat OpenShift no site Satellite.

• Um grupo de clusters Satellite que contém o cluster necessário para a cadeia de ferramentas. A cadeia de ferramentas neste tutorial suporta um grupo de clusters Satellite que contém apenas clusters Red Hat OpenShift.

• Segredos de extração de imagem. Certise-se de configurar os segredos de pull image que são necessários para implementar imagens de aplicativos em seu espaço de nomes de cluster. Para obter mais informações, consulte Entendendo como autorizar o seu cluster a extrair imagens de um registro privado.

• Um local Satellite para implementação dos recursos.

• Uma instância do serviço Continuous Delivery.

Introdução

Comece a criar uma cadeia de ferramentas em IBM Cloud.

1. Faça login no IBM Cloud As cadeias de ferramentas com suas credenciais IBM Cloud.
2. Selecione o Grupo de Recursos e Localização para sua cadeia de ferramentas.
3. Clique em “Criar cadeia de ferramentas ”.
4. Na página Criar uma cadeia de ferramentas, selecione Satellite sob Filtros para exibir templates que são aplicáveis para Satellite.
5. Selecione o modelo Deploy Kubernetes para vários clusters template.
6. Leia através das informações para entender como as cadeias de ferramentas funcionam e, em seguida, clique em Iniciar.

Definindo as configurações da cadeia

Defina o nome, região e grupo de recursos para a cadeia de ferramentas.

1. Forneça o nome para a cadeia de ferramentas.
2. Selecione a região onde deseja que a cadeia de ferramentas seja criada.
3. Selecione um grupo de recursos onde deseja que a cadeia de ferramentas seja criada.
4. Clique em Continuar.

Definindo seu repositório de origem

Especifique detalhes do repositório de origem que deseja que esta cadeia de ferramentas ouça. Você pode especificar esta info usando opções de configuração padrão ou opções avançadas de configuração.

1. Selecione seu provedor de origem. Dependendo do provedor de origem que você escolher, opções específicas para aquele provedor de origem são exibidas. Por exemplo, você pode selecionar Github Enterprise Whitewater como o provedor de origem.

2. Defina o repositório de origem.

   • Para usar um novo repositório para esta cadeia de ferramentas, clique em Criar novo repositório de origem e nomeia o novo repositório.
   • Para usar um repositório existente para essa cadeia de ferramentas, clique em “Usar repositório de código-fonte existente” e forneça o endereço do repositório URL. Selecione o provedor de origem e insira o endereço URL do seu repositório, por exemplo: https://github.com/my-org/my-repo.

3. Clique em Continuar.

Se você deseja acessar configurações de repositório de origem mais avançadas, como usar um servidor personalizado e alterar o comportamento de clonagem, selecione Switch para configuração avançada.

Configurando seu pipeline de entrega

Nomeie o pipeline de entrega para implantar suas aplicações em vários clusters do seu grupo de clusters “ Satellite ”.

1. Digite o nome do pipeline, que é exibido em sua cadeia de ferramentas.

2. Clique em Continuar.

Fornecendo uma chave API

Forneça as informações da chave da API do IBM Cloud que a cadeia de ferramentas pode usar para acessar seu endereço Satellite.

Se você tiver uma chave API existente ou várias chaves de API existentes, siga estes passos.

1. Selecione o provedor secreto ou provedores que você usa. Você pode selecionar uma ou mais opções.

2. Clique em Continuar.

3. Forneça as informações necessárias para acessar o seu provedor secreto.

Se você não tiver uma chave API existente, você pode ignorar as opções nesta página e clicar em Continuar para prosseguir para a próxima página, onde é possível criar uma chave API IBM Cloud e salvá-la em um provedor secreto.

Configurando o arquivo Satellite

Especifique as configurações que a ferramenta de configuração do Satellite pode utilizar ao implantar recursos.

1. Forneça uma chave de API d IBM Cloud. Se você não forneceu uma chave API existente IBM Cloud na página anterior, você pode criar uma nova chave API IBM Cloud ao clicar em Novo.

   Você pode salvar esta chave de um provedor secreto de sua escolha para reutilização, selecionando essa opção ao criar a nova chave ou clicando no ícone de chave.

2. Defina o espaço de nomes que deseja que seus recursos sejam implementados. Este deve ser um espaço de nomes existente.

3. Especificar a ramificação para implantar o recurso para; por exemplo, v1.

4. Forneça o caminho para implementar o recurso para; por exemplo, deployments.

5. Selecione o grupo de clusters para receber os recursos que você está implementando.

6. Forneça o nome exibido da configuração Satellite.

7. Clique em Continuar.

Revisando o resumo

Revise o resumo e confirme para criar sua cadeia de ferramentas.

• Para alterar quaisquer parâmetros fornecidos anteriormente, clique em Voltar.

• Para criar a cadeia de ferramentas com os parâmetros fornecidos, clique em Criar cadeia de ferramentas.

Testando a cadeia de ferramentas

Quando a cadeia de ferramentas é criada, a página Visão Geral da cadeia de ferramentas é exibida. Nesta página, você pode visualizar os repositórios, os pipelines e quaisquer ferramentas do IBM Cloud associadas a essa cadeia de ferramentas.

Sob Repositórios é o seu repositório de origem, bem como repositórios adicionais para suas tarefas de catálogo e pipeline de Tekton. Se você estiver confortável com o uso do Tekton, você pode ir a estes repositórios de Tekton para fazer alterações em sua cadeia de ferramentas.

Sob pipelines de entrega, você pode ver o status do seu pipeline executado. Você pode clicar no nome do pipeline para ver detalhes sobre seu pipeline e configurar A partir desta visão geral do pipeline, você pode configurar os gatilhos para o seu pipeline. Os triggers definem quando o pipeline começa.

Você pode iniciar o pipeline de entrega de uma das seguintes maneiras.

• Acionar o pipeline de entrega manualmente, configurando um disparador manual.
• Empurre um commit para o repo de origem de implementação conforme definido por um disparador de repositório Git. Para configurar um acionador de repositório Git, veja Implementando uma nova versão do seu app a partir de um ramo diferente.

Para iniciar uma execução de pipeline manual, siga estes passos.

1. No Overview da sua cadeia de ferramentas sob pipelines de entrega, selecione o pipeline de entrega para visualizar seu status.
2. Clique em Executar pipeline.
3. Revise as propriedades do disparo para ter certeza de que elas combinam com a sua configuração.
4. Clique em Executar para executar a cadeia de ferramentas e implementar seu app.
5. Opcional: Clique no nome da execução para ver o status, logs e detalhes.
6. Opcional: Depois que o app estiver em execução, vá em Satellite Configuração ou execute ibmcloud sat config comando para ver seus recursos Satellite Config.

Verificando se o app de amostra está em execução

Depois que sua cadeia de ferramentas estiver configurada e o Delivery Pipeline for concluído com sucesso, execute as etapas a seguir para verificar seu aplicativo.

1. A partir da página Clusters, clique no cluster que você usou para implementar o seu app.
2. Clique em Console da web do OpenShift.
3. Na seção Workloads > Pod, filtrar pelo projeto ou pelo espaço de nomes do cluster, e verificar se os pods estão em execução.
4. Na seção Rede > Rotas, filtre por projeto ou namespace do cluster e localize o aplicativo URL.
5. Verifique se o aplicativo está em execução acessando o endereço URL no seu navegador.
6. Opcional: Você pode visualizar sua configuração Satellite no console, ou executando o comando ibmcloud sat config ls .

Implementando uma nova versão do seu app a partir de um ramo diferente

Se você tem várias filiais em seu repositório representando várias versões do app, você pode implementar um ramo diferente para ver uma nova versão do seu app em execução. Siga estas etapas para modificar a cadeia de ferramentas para implementar um ramo diferente do seu repositório de origem.

1. No Overview de sua cadeia de ferramentas, selecione o pipeline de entrega para modificar.
2. Clique em “Triggers ”.
3. Clique no menu de ação para o gatilho commit-push.
4. Selecione Editar.
5. No campo Branch, selecione o ramo que deseja implementar. Por exemplo, v2.
6. Na linha deployment-branch sob Propriedades, clique no ícone Editar.
7. Modifique o valor desta propriedade para o nome do ramo que deseja implantar. Por exemplo, v2.
8. Salve as mudanças.
9. Verifique se o seu aplicativo está executando a nova versão acessando a página URL com o seu navegador.
10. Opcional: Visualize a nova versão de sua configuração no Satellite configurações console ou executando rodando o comando ibmcloud sat config get --config CONFIG .

Agora você pode implementar recursos do Kubernetes para vários clusters com uma única cadeia de ferramentas.