Configurar CLI

Nesta etapa, você configurará oc para apontar para seu cluster recém-criado. A CLI da Red Hat OpenShift on IBM Cloud Container Platform apresenta comandos para gerenciar seus aplicativos, bem como ferramentas de nível inferior para interagir com cada componente do seu sistema. A CLI está disponível usando o comando oc.

1. Quando o cluster estiver pronto, clique em OpenShift web console para abrir o console.
2. No console da web, no menu suspenso no canto superior direito da página, clique em Copiar comando de login e, em seguida, clique no link Exibir token.
3. Copie o texto encontrado em Log in with this token.
4. Depois de fazer login usando o comando oc login, execute o comando abaixo para ver todos os namespaces em seu cluster.

   oc get ns
   

Criar um projeto

Um namespace do Kubernetes fornece um mecanismo para definir o escopo de recursos em um cluster. No Red Hat OpenShift on IBM Cloud, um projeto é um namespace do Kubernetes com anotações adicionais.

1. Defina uma variável de ambiente denominada MYPROJECT e configure o nome do aplicativo substituindo <your-initials> por suas próprias iniciais:

   export MYPROJECT=<your-initials>-openshiftapp
   

2. Crie um novo projeto.

   oc new-project $MYPROJECT
   

   Depois de criar um projeto usando o comando acima, você é automaticamente alternado para esse projeto e todos os comandos que seguem são executados no contexto desse projeto. Se você precisar alternar projetos ou voltar para esse projeto em um estágio posterior, use o comando oc project $MYPROJECT

Implementar um aplicativo

Com o comando oc new-app, é possível criar aplicativos por meio do código-fonte em um repositório Git local ou remoto.

1. Crie um aplicativo usando a estratégia de construção do docker para criar uma imagem de contêiner no repositório por meio de um Dockerfile. Você está configurando o nome do aplicativo para o nome do projeto para simplicidade.

   oc new-app https://github.com/IBM-Cloud/openshift-node-app --name=$MYPROJECT --strategy=docker --as-deployment-config
   

   Se houver um arquivo Jenkins na raiz ou no diretório de contexto especificado do repositório de origem ao criar um novo aplicativo, Red Hat OpenShift on IBM Cloud irá gerar uma estratégia de construção de pipeline. Caso contrário, ele gera uma estratégia de construção source. É possível sempre substituir a estratégia de construção configurando o sinalizador --strategy

2. Para verificar a criação e o envio da imagem do contêiner do construtor para o Red Hat OpenShift on IBM Cloud Container Registry (OCR) interno, execute o comando abaixo.

   oc logs -f buildconfig/$MYPROJECT
   

   Seu cluster é configurado com o Red Hat OpenShift on IBM Cloud Container Registry interno para que o Red Hat OpenShift on IBM Cloud possa construir, implementar e gerenciar automaticamente o seu ciclo de vida de aplicativo de dentro do cluster.

3. Aguarde até que a compilação seja bem-sucedida e a imagem seja enviada. É possível verificar o status de implementação e serviço executando o comando abaixo.

   oc status
   

Acesse o aplicativo por meio do domínio fornecido IBM

Para acessar o aplicativo, é necessário criar uma rota. Uma rota anuncia seu serviço para o mundo.

1. Crie uma rota executando o comando abaixo em um terminal.

   oc expose service/$MYPROJECT
   

2. Você pode acessar o aplicativo por meio de um domínio fornecido pelo IBM. Execute o comando abaixo para obter o URL.

   oc get route/$MYPROJECT
   

3. Copie o valor do nome do host em HOST/PORT e cole o endereço URL em um navegador para ver seu aplicativo em ação em http://<hostname>. Certifique-se de usar http no URL.

4. Define uma variável de ambiente que aponta para o nome do host.

   export HOST=<hostname>
   

Proteger a rota de domínio padrão fornecida pela IBM

1. Para criar uma rota HTTPS segura criptografada com o certificado padrão para o Red Hat OpenShift on IBM Cloud, é possível usar o comando create route.

   oc create route edge $MYPROJECT-https --service=$MYPROJECT --port=3000
   

2. Para a URL do HOST HTTPS, execute oc get routes. Copie e cole a URL com HTTPS (https://<HOST>) ao lado da rota $MYPROJECT-https em um navegador. Desta vez, você pode usar https no URL.

Ajuste de escala manual

1. É possível alcançar ajuste de escala manual de seus pods com o comando oc scale. O comando configura um novo tamanho para uma configuração de implementação ou um controlador de replicação

   oc scale dc/$MYPROJECT --replicas=2
   

2. É possível ver um novo pod sendo provisionado executando o comando oc get pods.
3. Execute novamente a etapa Monitoramento para ver as métricas atualizadas.

Auto-scaling

É possível usar um ajustador de escala automático de pod (HPA) para especificar como o Red Hat OpenShift on IBM Cloud deve aumentar ou diminuir automaticamente a escala de uma configuração de implementação (dc) ou de um controlador de replicação (rc), com base em métricas coletadas dos pods que pertencem a esse dc ou rc.

1. Para que seja possível configurar o ajuste automático de escala para os seus pods, primeiro é necessário configurar os limites de recurso nos pods em execução no cluster. Os limites permitem que você escolha o uso mínimo e máximo de CPU e de memória para um pod. É possível configurar os limites e as solicitações em um contêiner usando o comando oc set resources.

   oc set resources dc/$MYPROJECT --limits=cpu=250m,memory=512Mi --requests=cpu=100m,memory=256Mi
   

   Para verificar, execute oc describe dc/$MYPROJECT e procure Limits e Requests.
2. Para criar um ajustador automático de escala, é necessário executar o comando oc autoscale com os limites inferior (mín.) e superior (máx.) para o número de pods que podem ser configurados pelo ajustador automático de escala e a utilização média de destino de CPU (representada como um percentual de CPU solicitada) sobre todos os pods. Para testar, vamos configurar --cpu-percent para 5%.

   oc autoscale dc/$MYPROJECT \
    --min=1 \
    --max=5 \
    --cpu-percent=5
   

3. Reexecute a etapa Monitoramento para gerar carga no aplicativo.
4. Você pode ver novos pods sendo provisionados executando o comando oc get pods --watch ou olhando para o aplicativo no console web.
5. Remova o escalador automático:

   oc delete hpa/$MYPROJECT
   

Clonar um aplicativo de amostra

Nesta seção, você clonará um repositório GitHub que é fornecido com um arquivo de modelo e um shell script para gerar um arquivo yaml a partir de suas variáveis de ambiente criadas anteriormente. O arquivo gerado é usado para criar uma imagem de contêiner, enviar a imagem para o registro de contêiner privado e implantar um novo aplicativo.

1. Em um terminal, execute o comando abaixo para clonar o repositório GitHub em seu computador:

   git clone https://github.com/IBM-Cloud/openshift-node-app
   

2. Vá para o diretório do aplicativo:

   cd openshift-node-app
   

Atualizar o BuildConfig e enviar por push a imagem do construtor para o Container Registry

Nesta etapa, você executa um script para atualizar as seções do arquivo openshift.template.yaml e gerar um novo arquivo yaml apontando para seu namespace Container Registry.

1. Execute o script de bash abaixo para atualizar os itens temporários no arquivo openshift.template.yaml e gerar o arquivo openshift_private_registry.yaml.

   ./generate_yaml.sh use_private_registry
   

2. Execute o comando de exportação na saída para configurar a variável de ambiente MYPROJECT existente com o novo nome do aplicativo. Execute echo $MYPROJECT para ver o novo nome do aplicativo.

3. Opcionalmente, verifique o arquivo openshift_private_registry.yaml gerado para ver se todos os itens temporários foram atualizados com as respectivas variáveis de ambiente. Abaixo estão três lugares para fazer uma verificação rápida. É possível pular para a próxima seção.

4. Opcional Localize o objeto ImageStream com o atributo name definido para seu projeto ($MYPROJECT) e verifique se os espaços reservados $MYREGISTRY,$MYNAMESPACE e $MYPROJECT na definição dockerImageRepository de spec estão atualizados

   -
   apiVersion: image.openshift.io/v1
   kind: ImageStream
   metadata:
     annotations:
       openshift.io/generated-by: OpenShiftNewApp
     creationTimestamp: null
     labels:
       app: $MYPROJECT
       app.kubernetes.io/component: $MYPROJECT
       app.kubernetes.io/instance: $MYPROJECT
     name: $MYPROJECT
   spec:
     dockerImageRepository: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT
     lookupPolicy:
       local: false
   status:
       dockerImageRepository: ""
   

   Um fluxo de imagem e suas tags associadas fornecem uma abstração para referenciar imagens de contêiner de dentro do Red Hat OpenShift on IBM Cloud Container Platform

5. Opcional: verifique na seção spec em BuildConfig se o conjunto de saída para o tipo DockerImage e se os itens temporários name foram atualizados.

   spec:
     nodeSelector: null
     output:
       to:
         kind: DockerImage
         name: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT:latest
       pushSecret:
         name: push-secret
   

   Uma construção é o processo de transformar parâmetros de entrada em um objeto resultante. Mais frequentemente, o processo é usado para transformar parâmetros de entrada ou código-fonte em uma imagem executável. Um objeto BuildConfig é a definição de todo o processo de construção.

6. Opcional procure containers, verifique a image e o name

   containers:
   - image: $MYREGISTRY/$MYNAMESPACE/$MYPROJECT:latest
     name: $MYPROJECT
   

7. Se atualizado, salve o arquivo YAML.

Implementar o aplicativo usando o IBM Cloud Container Registry

Nesta seção, você implementará o aplicativo no cluster usando o arquivo openshift_private_registry.yaml gerado. Depois de implementado, você acessará o aplicativo criando uma rota.

1. Crie um novo aplicativo OpenShift junto com um buildconfig(bc), deploymentconfig(dc), service(svc), imagestream(is) usando o yaml atualizado.

   oc apply -f openshift_private_registry.yaml
   

2. Para verificar a criação da imagem do contêiner do construtor e o envio para o site Container Registry, execute o comando abaixo.

   oc logs -f bc/$PRIVREG
   

   Nos logs, você verá a mensagem abaixo se a imagem do contêiner for enviada para o registro de contêiner privado.

   Pushing image us.icr.io/mods15/vmac-openshift-app-registry:latest ...
   Getting image source signatures
   Copying blob sha256:9d038e1c7afbe92c29313557c02110e8fb796818ebb78441c68929381103a94b
   Copying blob sha256:61c671f49591a059c9b6728a9f84c16f5b00126470112ee9c9f9e01dbbfcc3ea
   Copying blob sha256:e2787650308235c87eff7d2b88c3ab217e84b74a3fa9696103bd46bb99068c7a
   Copying blob sha256:dcef409117430ed9906a59ad0a3ea0752061fbf8a9e544f4edd77667a25d85ae
   Copying blob sha256:a1f889dd610c6510c7fc091a51c247463f3cc9a7c67bdc397c9632168808f7d2
   Copying blob sha256:bd278801acd18ada10f43b732113a6fffc163011862ea6cde729f8dc59e64222
   Copying blob sha256:2d6c03ed5d15be86cdef7d9c0c9fea40a3f6b89662bca59680d037074f52bb38
   Copying blob sha256:fa2ef7f80d6fc9543f6eb472846931ed1cec2b5f776d1b67bcb1b9942e1a947e
   Copying blob sha256:ff5a4e4d3690ccc931900b63714d326cc53a58e644f8d0a4f06bf8c62f11c5c7
   Copying config sha256:01aa1ebb7be74529867106100c4e699ca2ae87f8242460771527f772e6a3d174
   Writing manifest to image destination
   Storing signatures
   Successfully pushed us.icr.io/mods15/vmac-openshift-app-registry@sha256:6847b889397704b9fb8c3122c84b505c3dc5f99a0669fb69f534d3504eec385d
   Push successful
   

3. Você pode verificar o status da implantação e do serviço.

   oc status
   

4. Importe manualmente o fluxo de imagem mais recente para garantir que a implementação ocorra o mais rápido possível.

   oc import-image $PRIVREG
   

   Você também pode usar o comando se a implantação estiver demorando mais. Consulte este link para obter mais informações.

5. Expor o serviço para criar uma nova rota.

   oc expose service/$PRIVREG
   

6. Você pode acessar o aplicativo por meio do domínio fornecido IBM. Execute o comando abaixo para obter o URL.

   oc get route/$PRIVREG
   

7. Copie o valor do nome do host em HOST/PORT e cole o endereço URL em um navegador para ver seu aplicativo em ação em http://<hostname>. Certifique-se de usar http no URL.

   Você deve ver o mesmo aplicativo exposto em uma rota diferente e implementado com a imagem de contêiner armazenada em um registro de contêiner privado.

Criar um token de implementação do Git

Nesta seção, você criará um token de implementação de Git para permitir o acesso de somente leitura ao seu repositório.

Para gerar um token de implementação:

1. No painel de navegação da página do repositório Git, clique em Configurações > Repositório.
2. Clique em Expandir ao lado de Tokens de implementação.
   1. No campo Nome, digite foropenshift e, em seguida, selecione read_repository em Escopos. Finalmente clique em Criar token de implementação.
   2. Salve o nome do usuário e a senha gerados para referência futura.
3. No painel de navegação, clique em Visão geral do projeto e, em seguida, clique em Clonar e copie Clonar com HTTPS URL. Salve a URL para referência futura.
4. Defina variáveis de ambiente para o nome do usuário, a senha e a URL do repositório Git privado a serem usados com o arquivo YAML posteriormente no tutorial

   export GIT_TOKEN_USERNAME=<PRIVATE_GIT_DEPLOY_TOKEN_USERNAME>
   export GIT_TOKEN_PASSWORD=<PRIVATE_GIT_DEPLOY_TOKEN_PASSWORD>
   export REPO_URL=<PRIVATE_GIT_REPO_URL>
   

Implementar um novo aplicativo usando o registro privado e o código do repositório privado

1. Execute o script de bash abaixo para atualizar os itens temporários no arquivo openshift.template.yaml e gerar o arquivo openshift_private_reposity.yaml.

   ./generate_yaml.sh use_private_repository
   

2. Execute o comando de exportação na saída para configurar a variável de ambiente MYPROJECT existente com novo nome do projeto.

3. Além dos itens temporários do registro de contêiner privado, o script também substituirá a REPO_URL na especificação BuildConfig pelas variáveis de ambiente que você configurou na etapa acima.

    source:
      git:
        uri: $REPO_URL
      type: Git
   

4. Crie um novo aplicativo openshift junto com um buildconfig(bc), deploymentconfig(dc), service(svc), imagestream(is) usando o yaml atualizado

   oc apply -f openshift_private_repository.yaml
   

5. É possível verificar os logs do construtor

   oc logs -f bc/$PRIVREPO
   

6. Você pode verificar o status da implantação e do serviço usando.

   oc status
   

7. Importe manualmente o fluxo de imagem mais recente para garantir que a implementação ocorra o mais rápido possível.

   oc import-image $PRIVREPO
   

8. Expor o serviço para criar uma nova rota.

   oc expose service/$PRIVREPO
   

9. Você pode acessar o aplicativo por meio do domínio fornecido IBM. Execute o comando abaixo para obter o URL.

   oc get route/$PRIVREPO
   

10. Copie o valor do nome do host em HOST/PORT e cole o endereço URL em um navegador para ver seu aplicativo em ação em http://<hostname>. Certifique-se de usar http no URL.

    Um novo aplicativo é implementado com o código do repositório Git privado e a imagem de contêiner do namespace do registro privado.

Atualizar o aplicativo e reimplantá-lo

Nesta etapa, você automatizará o processo de construção e implementação. Sempre que você atualizar o aplicativo e enviar por push as mudanças no repositório privado, uma nova construção será executada gerando uma nova versão da imagem de contêiner. Essa imagem é então implementada automaticamente.

1. Você criará um novo acionador de Webhook GitLab. Os acionadores de Webhook permitem acionar uma nova compilação enviando uma solicitação para o terminal de API do Red Hat OpenShift on IBM Cloud Container Platform. É possível definir esses acionadores usando webhooks GitHub, GitLab, Bitbucket ou Genéricos.

   oc set triggers bc $PRIVREPO --from-gitlab
   

2. Para incluir um webhook no repositório GitLab, é necessária uma URL e um segredo

   • Para a URL do GitLab do webhook,

     oc describe bc/$PRIVREPO | grep -A 1 "GitLab"
     

   • Para o segredo que precisa ser passado na URL do webhook,

     oc get bc/$PRIVREPO -o yaml | grep -A 3 "\- gitlab"
     

   • Substitua <secret> na URL do webhook GitLab pelo valor do segredo em gitlab na saída de comando acima.

3. Abra seu repositório git privado em um navegador usando o link Git repo HTTPS e, em seguida, clique em Settings (Configurações ) e clique em Webhooks.

4. Cole o URL, selecione Push events como Trigger e clique em Add webhook. Deve-se ver a mensagem Webhook was created

5. Atualize o ImagePolicy do fluxo de imagem para consultar o Container Registry em um intervalo planejado para sincronizar a tag e os metadados de imagem. Isso atualizará a definição tags

   oc tag $MYREGISTRY/$MYNAMESPACE/${PRIVREPO}:latest ${PRIVREPO}:latest --scheduled=true
   

6. Abra o repositório clonado em um IDE para atualizar a tag h1 do arquivo public/index.html e alterá-la para Congratulations! <insert your name>.

7. Salve e envie o código para o repositório.

    git add public/index.html
   

    git commit -m "Updated with my name"
   

    git push -u origin master
   

8. É possível verificar o progresso da construção e implementar com o comando oc status. Quando a implementação for bem-sucedida, atualize o endereço de HOST da rota para ver o app da web atualizado.

   Às vezes, a implementação pode levar até 15 minutos para importar o fluxo de imagem mais recente. Você pode esperar ou importar manualmente usando o comando oc import-image $PRIVREPO. Consulte este link para obter mais informações.

Com HTTP

1. Crie uma rota expondo o serviço em um nome do host substituindo <HOSTNAME> pelo seu nome do host (por exemplo, www.example.com ou openshiftapp.example.com), para que os clientes externos possam atingi-lo pelo nome.

   oc expose svc/$PRIVREPO --hostname=<HOSTNAME> --name=$PRIVREPO-domain --port=3000
   

2. Acesse seu aplicativo em http://<HOSTNAME>/

Com HTTPS

1. Para criar uma rota HTTPS segura, é possível usar o seu próprio certificado e os arquivos de chaves de um CA como Vamos criptografar ou pedir por meio do Secrets Manager. Passe-os com o comando create route

   oc create route edge $PRIVREPO-httpsca --service=$PRIVREPO --cert=example.pem --key=example.key --hostname=<www.HOSTNAME> --port=3000
   

   Aqui, você usou finalização de Edge. Para aprender sobre outras rotas seguras e tipos de rescisão como passagem e nova criptografia, execute o comando oc create route --help)