Implantar um app de servidor da Web conteinerizado

Criar um registro gerenciado do Harbor

O GDC com isolamento físico oferece o Harbor como serviço, que é um serviço totalmente gerenciado que permite armazenar e gerenciar imagens de contêiner usando o Harbor.

Para usar o Harbor como serviço, primeiro é preciso criar uma instância de registro do Harbor e um projeto do Harbor.

Criar instância de registro do Harbor

Para criar uma instância do Container Registry do Harbor, siga estas etapas:

Criar um projeto do Harbor no registro

Crie um projeto do Harbor na instância do registro do Harbor para gerenciar as imagens de contêiner:

Configurar Docker

Para usar o Docker no registro do Harbor, siga estas etapas:

1. Configure o Docker para confiar no Harbor como serviço. Para mais informações, consulte Configurar o Docker para confiar na CA raiz do Harbor.

2. Configure a autenticação do Docker no Harbor. Para mais informações, consulte Configurar a autenticação do Docker para instâncias de registro do Harbor.

Criar secret de extração de imagem do Kubernetes

Como você está usando um projeto particular do Harbor, é necessário criar um secret de extração de imagem do Kubernetes.

1. Adicione uma conta de robô do projeto do Harbor para servir como sua conta de serviço.

   1. No console do Harbor, selecione seu projeto do Harbor.

   2. Clique em Contas de robô.

   3. Selecione Nova conta de robô.

   4. Dê um nome à nova conta de robô e defina as configurações adicionais.

   5. Clique em Adicionar.

   6. O nome e o secret da conta do robô são exibidos na tela de sucesso. Mantenha essa tela aberta para consulta na próxima etapa.

   Para mais informações, consulte a documentação do Harbor: https://goharbor.io/docs/2.8.0/working-with-projects/project-configuration/create-robot-accounts/#add-a-robot-account.

2. Em uma nova janela do terminal, faça login no Docker com sua conta de robô do projeto do Harbor e o token secreto:

   docker login ${INSTANCE_URL}
   

   Quando solicitado, insira o nome do projeto do robô para o Nome de usuário e o token secreto para a Senha que foram fornecidos na etapa anterior na tela de sucesso do console do Harbor.

3. Defina um nome arbitrário para o secret de extração de imagem:

   export SECRET=SECRET
   

4. Crie o secret necessário para a extração de imagens:

   kubectl create secret docker-registry ${SECRET}  \
       --from-file=.dockerconfigjson=DOCKER_CONFIG \
       -n ${NAMESPACE}
   

   Substitua DOCKER_CONFIG pelo caminho para o arquivo .docker/config.json.

5. Confirme se o secret existe no namespace do projeto do GDC:

   kubectl get secrets -n ${NAMESPACE}
   

   O resultado será o seguinte:

   NAME          TYPE                               DATA     AGE
   my-secret     kubernetes.io/dockerconfigjson     1        23s
   

Enviar imagem de contêiner para o registro gerenciado do Harbor

Neste tutorial, você vai fazer o download e enviar a imagem do servidor da Web nginx para o registro gerenciado do Harbor e usá-la para implantar um app de servidor da Web nginx de amostra em um cluster compartilhado do Kubernetes. O app de servidor da Web nginx está disponível no repositório público do Docker Hub.

1. Extraia a imagem nginx do Docker Hub para sua estação de trabalho local usando uma rede externa:

   docker pull nginx
   

2. Marque a imagem local com o nome do repositório:

   docker tag nginx ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
   

3. Envie a imagem do contêiner nginx para o registro gerenciado do Harbor:

   docker push ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
   

Criar um cluster do Kubernetes

Agora que você tem a imagem de contêiner nginx armazenada no registro gerenciado do Harbor e pode acessá-la, crie um cluster compartilhado do Kubernetes para executar o servidor da Web nginx.

Para mais informações sobre como criar um cluster compartilhado do Kubernetes, consulte Criar um cluster compartilhado. Para mais informações sobre as opções de configuração de cluster disponíveis, consulte Configurações de cluster do Kubernetes.

Implantar o app de contêiner de amostra

Agora você já pode implantar a imagem do contêiner nginx no cluster do Kubernetes.

O Kubernetes representa aplicativos como recursos Pod, que são unidades escalonáveis com um ou mais contêineres. O pod é a menor unidade implantável no Kubernetes. Normalmente, os pods são implantados como um conjunto de réplicas que podem ser escalonadas e distribuídas juntas no cluster. Uma maneira de implantar um conjunto de réplicas é por meio de uma Deployment do Kubernetes.

Nesta seção, você vai criar um Deployment do Kubernetes para executar o app de contêiner nginx no cluster. Essa implantação tem réplicas ou pods. Um pod Deployment contém apenas um contêiner: a imagem do contêiner nginx. Você também cria um recurso Service que oferece uma forma estável para os clientes enviarem solicitações aos pods do Deployment.

Implante o servidor da Web nginx no cluster do Kubernetes:

1. Faça login no cluster do Kubernetes e gere o arquivo kubeconfig com uma identidade de usuário. Defina o caminho do kubeconfig como uma variável de ambiente:

   export KUBECONFIG=CLUSTER_KUBECONFIG_PATH
   

2. Crie e implante os recursos personalizados Deployment e Service do Kubernetes:

   kubectl --kubeconfig ${KUBECONFIG} -n ${NAMESPACE} \
   create -f - <<EOF
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nginx-deployment
     labels:
       app: nginx
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nginx
     template:
       metadata:
         labels:
           app: nginx
       spec:
         containers:
         - name: nginx
           image: ${INSTANCE_URL}/${HARBOR_PROJECT}/nginx:1.25
           ports:
           - containerPort: 80
         imagePullSecrets:
         - name: ${SECRET}
   ---
   apiVersion: v1
   kind: Service
   metadata:
     name: nginx-service
   spec:
     selector:
       app: nginx
     ports:
       - port: 80
         protocol: TCP
     type: LoadBalancer
   EOF
   

3. Verifique se os pods foram criados pela implantação:

   kubectl get pods -l app=nginx -n ${NAMESPACE}
   

   O resultado será o seguinte:

   NAME                                READY     STATUS    RESTARTS   AGE
   nginx-deployment-1882529037-6p4mt   1/1       Running   0          1h
   nginx-deployment-1882529037-p29za   1/1       Running   0          1h
   nginx-deployment-1882529037-s0cmt   1/1       Running   0          1h
   

4. Crie uma política de rede para permitir todo o tráfego de rede para o namespace:

   kubectl --kubeconfig ${KUBECONFIG} -n ${NAMESPACE} \
   create -f - <<EOF
   apiVersion: networking.k8s.io/v1
   kind: NetworkPolicy
   metadata:
     annotations:
     name: allow-all
   spec:
     ingress:
     - from:
       - ipBlock:
           cidr: 0.0.0.0/0
     podSelector: {}
     policyTypes:
     - Ingress
   EOF
   

5. Exporte o endereço IP do serviço nginx:

     export IP=`kubectl --kubeconfig=${KUBECONFIG} get service nginx-service \
         -n ${NAMESPACE} -o jsonpath='{.status.loadBalancer.ingress[*].ip}'`
   

6. Teste o endereço IP do servidor nginx usando curl:

     curl http://$IP