Como usar seus próprios certificados TLS

Esta página descreve como configurar o Cloud Run for Anthos para usar certificados SSL/TLS próprios nos casos em que você não quer utilizar o recurso de certificados TLS gerenciados.

O gateway de entrada do Istio é compatível com o protocolo TLS fornecido pelo certificado depois que você o armazena em um secret do Kubernetes e o especifica na especificação do gateway de entrada do Istio.

Antes de começar

Para seguir estas instruções, é necessário ter seus próprios certificados TLS.

Como armazenar um certificado TLS/chave particular em um secret do Kubernetes

Para armazenar os certificados em um Secret, siga estas etapas:

  1. Copie os certificados no diretório atual.

  2. Use o comando a seguir para criar um secret que armazene os certificados, em que privkey.pem contenha sua chave particular de certificado e fullchain.pem contenha o certificado público:

    kubectl create --namespace gke-system secret tls SECRET_NAME \
      --key privkey.pem \
      --cert fullchain.pem
    

Como especificar o certificado TLS para o gateway de entrada do Istio

Modifique a especificação do gateway de entrada do Istio para usar o secret do Kubernetes que contém o certificado TLS:

  1. Abra a especificação do gateway compartilhado para edição:

    kubectl edit gateway gke-system-gateway --namespace knative-serving
  2. Especifique o certificado TLS usando o secret criado anteriormente. Basta adicionar a seguinte seção à especificação do gateway:

    - hosts:
      - "*"
      port:
        name: https
        number: 443
        protocol: HTTPS
      tls:
        mode: SIMPLE
        credentialName: SECRET_NAME
    

    As especificações do gateway ficarão assim:

    apiVersion: networking.istio.io/v1alpha3
    kind: Gateway
    metadata:
    # ... skipped ...
    spec:
      selector:
        istio: ingressgateway
      servers:
        - hosts:
          - "*"
          port:
            name: http
            number: 80
            protocol: HTTP
        - hosts:
          - "*"
          port:
            name: https
            number: 443
            protocol: HTTPS
          tls:
            mode: SIMPLE
            credentialName: SECRET_NAME
    

    Se você estiver adicionando vários certificados TLS para dois serviços diferentes em diferentes namespaces, a especificação do gateway poderá ser parecida com o seguinte:

    apiVersion: networking.istio.io/v1alpha3
    kind: Gateway
    metadata:
    # ... skipped ...
    spec:
      selector:
        istio: ingressgateway
      servers:
      - hosts:
        - "*"
        port:
          name: http
          number: 80
          protocol: HTTP
      - port:
          number: 443
          name: https-SERVICE1_NAME
          protocol: HTTPS
        tls:
          mode: SIMPLE
          credentialName: SECRET1_NAME
        hosts:
        - SERVICE1_NAME.NAMESPACE1.example.com
      - port:
          number: 443
          name: https-SERVICE2_NAME
          protocol: HTTPS
        tls:
          mode: SIMPLE
          credentialName: SECRET2_NAME
        hosts:
        - SERVICE2_NAME.NAMESPACE2.example.com
    
  3. Salve as alterações.

Após essa alteração, use o protocolo HTTPS para acessar seus serviços implantados.