Etapa 1: Implementar apps e criar serviços de app

Inicie implementando seus apps e criando serviços do Kubernetes para expô-los.

1. Implemente o seu app no cluster. Assegure-se de incluir um rótulo em sua implementação na seção de metadados de seu arquivo de configuração, como app: code. Este rótulo é necessário para identificar todos os pods em que seu app executa para que os pods estejam no balanceamento de carga de ingresso.

2. Para cada implementação de app que você deseja expor, crie um serviço ClusterIP do Kubernetes. O seu app deve ser exposto por um serviço do Kubernetes a ser incluído no balanceamento de carga do Ingress.

oc expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

Etapa 2: Configurar uma terminaçã TLS e com certificados TLS e segredos Kubernetes

Seu certificado do TLS deve ser armazenado como um segredo do Kubernetes em cada namespace onde seus aplicativos estejam hospedados.

Etapa 3: criar e configurar um controlador do Ingress privado

Após obter o certificado de domínio e TLS pronto, deve-se criar um controlador do Ingress privado e configurar o controlador com o domínio.

1. Crie um arquivo de configuração para um controlador do Ingress privado.

   apiVersion: operator.openshift.io/v1
   kind: IngressController
   metadata:
     name: private-ingress-controller
     namespace: openshift-ingress-operator
   spec:
     #defaultCertificate: If you are using a custom domain, specify the domain certificate
       #name: custom-certs-default
     replicas: 2
     domain: <domain>
     endpointPublishingStrategy:
       loadBalancer:
         scope: Internal
       type: LoadBalancerService
   

2. Crie o recurso IngressController no projeto openshift-ingress-operator do seu cluster. Quando você cria o IngressController, um controlador Ingress privado é automaticamente criado e implantado no projeto openshift-ingress com base nas configurações IngressController que você definiu na etapa anterior. Além disso, é criado um serviço de controlador do Ingress para disponibilizar o controlador do Ingress por meio de um endereço IP (clusters clássicos) ou de um nome de host da VPC (clusters da VPC).

   oc create -f private-ingress-controller.yaml -n openshift-ingress-operator
   

3. Execute o comando oc get e localize o endereço IP ou nome do host do VPC no campo EXTERNAL IP do serviço router-private-ingress-controller.

   oc get svc router-private-ingress-controller -n openshift-ingress
   

   Exemplo de saída para clusters clássicos.

   NAME                                  TYPE           CLUSTER-IP       EXTERNAL-IP    PORT(S)                      AGE
   router-private-ingress-controller     LoadBalancer   172.21.57.132    10.XX.XX.XX    80/TCP,443/TCP,1940/TCP      3m
   

   Saída de exemplo para clusters VPC:

   NAME                                  TYPE           CLUSTER-IP       EXTERNAL-IP                             PORT(S)                      AGE
   router-private-ingress-controller     LoadBalancer   172.21.57.132    1234abcd-us-south.lb.appdomain.cloud    80/TCP,443/TCP,1940/TCP      3m
   

4. Registre o endereço IP externo do serviço ou o nome do host de VPC com o domínio que você escolheu anteriormente.
   • Domínio customizado: trabalhe com seu provedor de DNS para incluir o endereço IP externo do serviço router-private-ingress-controller como um registro A (clusters clássicos) ou nome do host de VPC como um CNAME (clusters VPC) que é mapeado para o seu domínio customizado.
   • Domínio fornecido pela IBM: crie uma entrada DNS para o nome do host de VPC do serviço router-private-ingress-controller. Ao executar o comando a seguir, o subdomínio que você especificou no arquivo private-ingress-controller.yaml é gerado automaticamente e é registrado com o serviço router-private-ingress-controller. Um segredo do TLS para o domínio é gerado automaticamente no projeto que você especifica no qual seu app é executado. O nome secreto segue um formato truncado do subdomínio, como mycluster-a1b2cdef345678g9hi012j3kl4567890-0003.

       ibmcloud oc nlb-dns create vpc-gen2 --cluster <cluster_name_or_ID> --lb-host <VPC_hostname> --secret-namespace <project>
       ```
   
   
   

Etapa 4: Criar o Recurso do Ingresso

Os recursos do Ingress definem as regras de roteamento que o controlador do Ingress usa para rotear o tráfego para o seu serviço de app.

1. Defina um arquivo de configuração de recursos do Ingress que use o domínio fornecido pela IBM ou seu domínio customizado para rotear o tráfego de rede recebido para os serviços criados anteriormente.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: myingressresource
   spec:
     tls:
     - hosts:
       - <subdomain>
       secretName: <custom_secret_name>
     rules:
     - host: <subdomain>
       http:
         paths:
         - path: /<app1_path>
           backend:
               service:
                   name: <app1_service>
                   port:
                       number: 80
         - path: /<app2_path>
           backend:
               serivce:
                 name: <app2_service>
                 port:
                   number: 80
   

   tls

   Se quiser usar o TLS, inclua esta seção TLS em seu recurso. Substitua <domain> pelo seu subdomínio. Não use * para o seu host ou deixe a propriedade do host vazia para evitar falhas durante a criação do Ingresso.

   Substitua <tls_secret_name> pelo segredo que você criou anteriormente que mantém o seu certificado e chave TLS para um domínio customizado ou o segredo de TLS que foi gerado automaticamente para um subdomínio fornecido pela IBM.

   host

   Substitua <domain> pelo seu subdomínio.

   Se o seu cluster tiver diversos projetos nos quais os apps são expostos, um recurso do Ingress será necessário por projeto. É possível usar o mesmo subdomínio em cada recurso ou subdomínios diferentes em cada recurso. Por exemplo, se você usar um domínio curinga, será possível anexar um subdomínio curinga ao início do domínio, como subdomain1.custom_domain.net.

   Não use * para o seu host ou deixe a propriedade do host vazia para evitar falhas durante a criação do Ingresso.

   path

   Substitua <app_path> pelo caminho no qual seu aplicativo está em escuta. O caminho é anexado ao domínio fornecido pela IBM ou ao seu domínio customizado para criar uma rota exclusiva para o app. Quando você insere essa rota em um navegador da web, o tráfego de rede é roteado para o controlador de Ingresso. O controlador de ingresso consulta o serviço associado e envia o tráfego de rede para o serviço. O serviço então encaminha o tráfego para os pods nos quais o app é executado. Muitos apps não atendem em um caminho específico, mas usam o caminho raiz e uma porta específica. Neste caso, defina o caminho raiz como / e não especifique um caminho individual para o seu app.

   Por exemplo, para usar http://domain/, insira / como o caminho.. Para http://domain/app1_path, insira /app1_path como o caminho.

   serviceName

   Substitua <app1_service> e <app2_service>, e assim por diante, pelo nome dos serviços que você criou para expor seus apps. Se os seus apps forem expostos por serviços em diferentes projetos no cluster, inclua somente os serviços de app que estão no mesmo projeto. É necessário criar um recurso do Ingress para cada projeto que contenha os aplicativos que você deseja expor.

   servicePort

   A porta na qual o serviço atende. Use a mesma porta que você definiu quando criou o serviço do Kubernetes para seu app.

2. Crie o recurso de Ingresso para seu cluster. Assegure-se de que o recurso seja implementado no mesmo projeto que os serviços de app especificados no recurso.

   oc apply -f myingressresource.yaml -n <project>
   

3. Verifique se o recurso de Ingresso foi criado com êxito. Se as mensagens nos eventos indicarem um erro na configuração do seu recurso, corrija os valores no arquivo de recursos e reaplique o arquivo ao recurso.

   oc describe ingress myingressresource
   

Seu recurso do Ingress é criado no mesmo projeto que seus serviços de app e seus apps são registrados com o controlador do Ingress.

Etapa 5: acessar seu app por meio de sua rede privada

1. Clusters clássicos: Antes de acessar o seu app, certise-se de que você pode acessar um serviço de DNS. Para usar o provedor de DNS externo padrão, é necessário configurar os nós de borda com acesso público e definir um endereço de domínio de pesquisa(Virtual Router Appliance ).

2. De dentro de sua rede privada, insira a URL do serviço de aplicativo em um navegador da web.

   https://<domain>/<app1_path>
   

   Se tiver exposto diversos apps, acesse-os mudando o caminho anexado à URL.

   https://<domain>/<app2_path>
   

   Se você usa um domínio curinga, acesse esses apps com os seus próprios subdomínios.

   http://<subdomain1>.<domain>/<app1_path>
   

   http://<subdomain2>.<domain>/<app1_path>
   

Não é possível conectar ao seu app por meio do Ingress? Tente Resolução de problemas do Ingress.

Etapa 1: Implementar apps e criar serviços de app

Inicie implementando seus apps e criando serviços do Kubernetes para expô-los.

1. Implemente o seu app no cluster. Assegure-se de incluir um rótulo em sua implementação na seção de metadados de seu arquivo de configuração, como app: code. Este rótulo é necessário para identificar todos os pods em que seu app executa para que os pods estejam no balanceamento de carga de ingresso.

2. Para cada implementação de app que você deseja expor, crie um serviço ClusterIP do Kubernetes. O seu app deve ser exposto por um serviço do Kubernetes a ser incluído no balanceamento de carga do Ingress.

oc expose deploy <app_deployment_name> --name my-app-svc --port <app_port> -n <namespace>

Etapa 2: Configurar uma terminaçã TLS e com certificados TLS e segredos Kubernetes

Seu certificado do TLS deve ser armazenado como um segredo do Kubernetes em cada namespace onde seus aplicativos estejam hospedados.

• Para usar o domínio Ingress gerenciado pelo IBM, consulte a seção “Configurando segredos do TLS para o subdomínio Ingress fornecido pelo IBM ”.

• Para usar um domínio criado por você mesmo, como um domínio registrado em um provedor externo, consulte a seção “Configurando segredos d TLS ” para subdomínios personalizados.

Etapa 3: Criar o recurso de Ingresso

Os recursos do Ingress definem as regras de roteamento que o controlador do Ingress usa para rotear o tráfego para o seu serviço de app.

1. Defina um arquivo de configuração de recursos do Ingress que use o domínio fornecido pela IBM ou seu domínio customizado para rotear o tráfego de rede recebido para os serviços criados anteriormente.

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: myingressresource
   spec:
     tls:
     - hosts:
       - <custom_domain>
       secretName: <custom_secret_name>
     rules:
     - host: <domain>
       http:
         paths:
         - path: /<app1_path>
           backend:
               service:
                 name: <app1_service>
                 port:
                   number: 80
         - path: /<app2_path>
           backend:
               service:
                 name: <app2_service>
                 port:
                   number: 80
   

   tls

   Se quiser usar o TLS, inclua esta seção TLS em seu recurso.

   Substitua <domain> pelo seu subdomínio. Não use * para o seu host ou deixe a propriedade do host vazia para evitar falhas durante a criação do Ingress.

   Substitua <tls_secret_name> pelo segredo que você criou anteriormente que mantém o seu certificado e chave TLS para um domínio customizado ou o segredo de TLS que foi gerado automaticamente para um subdomínio fornecido pela IBM.

   host

   Substitua <domain> pelo subdomínio do Ingress fornecido pela IBM ou o domínio customizado.

   Se o seu cluster tiver diversos projetos nos quais os apps são expostos, um recurso do Ingress será necessário por projeto. É possível usar o mesmo subdomínio em cada recurso ou subdomínios diferentes em cada recurso. Por exemplo, se você usar um domínio curinga, poderá anexar um subdomínio curinga no início do domínio, como subdomain1.custom_domain.net ou subdomain1.mycluster-<hash>-0000.us-south.containers.appdomain.cloud. Não use * para o seu host ou deixe a propriedade do host vazia para evitar falhas durante a criação do Ingresso.

   path

   Substitua <app_path> pelo caminho no qual seu aplicativo está em escuta. O caminho é anexado ao domínio fornecido pela IBM ou ao seu domínio customizado para criar uma rota exclusiva para o app. Quando você insere essa rota em um navegador da web, o tráfego de rede é roteado para o controlador de Ingresso. O controlador de ingresso consulta o serviço associado e envia o tráfego de rede para o serviço. O serviço então encaminha o tráfego para os pods nos quais o app é executado. Muitos apps não atendem em um caminho específico, mas usam o caminho raiz e uma porta específica. Neste caso, defina o caminho raiz como / e não especifique um caminho individual para o seu app.

   Por exemplo, para usar http://domain/, insira / como o caminho.. Para http://domain/app1_path, insira /app1_path como o caminho.

   name

   Substitua <app1_service> e <app2_service>, e assim por diante, pelo nome dos serviços que você criou para expor seus apps. Se os seus apps forem expostos por serviços em diferentes projetos no cluster, inclua somente os serviços de app que estão no mesmo projeto. Deve-se criar um recurso do Ingress para cada projeto no qual haja apps a serem expostos.

   port

   A porta na qual o serviço atende. Use a mesma porta que você definiu quando criou o serviço do Kubernetes para seu app.

2. Crie o recurso de Ingresso para seu cluster. Assegure-se de que o recurso seja implementado no mesmo projeto que os serviços de app especificados no recurso.

   oc apply -f myingressresource.yaml -n <project>
   

3. Verifique se o recurso de Ingresso foi criado com êxito. Se as mensagens nos eventos indicarem um erro na configuração do seu recurso, corrija os valores no arquivo de recursos e reaplique o arquivo ao recurso.

   oc describe ingress myingressresource
   

Seu recurso do Ingress é criado no mesmo projeto que seus serviços de app e seus apps são registrados com o controlador do Ingress.

Etapa 4: Acesse seu aplicativo

Em um navegador da web, insira a URL do serviço de app a ser acessado.

https://<domain>/<app1_path>

Se tiver exposto diversos apps, acesse-os mudando o caminho anexado à URL.

https://<domain>/<app2_path>

Se você usa um domínio curinga, acesse esses apps com os seus próprios subdomínios.

http://<subdomain1>.<domain>/<app1_path>

http://<subdomain2>.<domain>/<app1_path>

Não é possível conectar ao seu app por meio do Ingress? Tente Resolução de problemas do Ingress.