Proxy de front-end usando Nginx

Console

1. Acesse a página do Secret Manager no console do Google Cloud:

   Acessar o Secret Manager

2. Clique em Criar secret.

3. No campo do formulário name, insira nginx_config.

4. Faça upload do arquivo nginx.conf localizado em multi-container/hello-nginx-sample/nginx.conf como o valor do secret.

5. Mantenha os valores padrão (Google-managed encryption key, etc).

6. Clique em Criar secret.

7. Conceda à conta de serviço de computação do projeto acesso a esse novo secret. Para fazer isso, acesse a página IAM no console do Google Cloud:

   Acessar IAM

8. Localize a conta de serviço principal com o nome: Compute Engine default service account e clique em Editar principal.

9. Clique em Adicionar outro papel e selecione Acessador de secrets do Secret Manager.

10. Clique em Salvar.

gcloud

1. Em um terminal, use o seguinte comando para criar um novo secret nginx_config no Secret Manager:

   gcloud secrets create nginx_config --replication-policy='automatic' --data-file='./nginx.conf'

2. Conceda à conta de serviço de computação do projeto acesso a esse novo secret com o comando

   export PROJECT_NUMBER=$(gcloud projects describe $(gcloud config get-value project) --format='value(projectNumber)')
   gcloud secrets add-iam-policy-binding nginx_config --member=serviceAccount:$PROJECT_NUMBER-compute@developer.gserviceaccount.com --role='roles/secretmanager.secretAccessor'

3. Verifique se o secret foi criado executando gcloud secrets list.

Console

Navegue até Implantar o serviço para ver as instruções completas do console.

YAML

1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço, faça o download da configuração YAML correspondente:

   gcloud run services describe SERVICE --format export > service.yaml

2. Em service.yaml, inclua o seguinte:

   metadata:
     name: "MC_SERVICE_NAME"
     labels:
       cloud.googleapis.com/location: "REGION"
     annotations:
       # Required to use Cloud Run multi-containers (preview feature)
       run.googleapis.com/launch-stage: BETA
       run.googleapis.com/description: sample tutorial service
       # Externally available
       run.googleapis.com/ingress: all

Esta seção descreve a revisão do serviço, incluindo propriedades que podem variar de uma revisão para outra.

Console

Navegue até Implantar o serviço para ver as instruções completas do console.

YAML

Em service.yaml, anexe o seguinte:

spec:
  template:
    metadata:
      annotations:
        # Defines container startup order within multi-container service.
        # Below requires hello container to spin up before nginx container,
        # which depends on the hello container.
        # https://cloud.google.com/run/docs/configuring/containers#container-ordering
        run.googleapis.com/container-dependencies: "{nginx: [hello]}"

Observe a anotação container-dependencies que diz ao Cloud Run para aguardar a inicialização do contêiner hello antes de iniciar o contêiner nginx. Caso contrário, se o contêiner nginx começar primeiro, ele pode tentar fazer proxy de uma solicitação da Web para o contêiner do app da Web que não está pronto, o que geraria respostas de erro da Web.

Como alternativa, cada contêiner pode ter uma propriedade de nome definida, que pode ser usada para se referir a ele em outras diretivas. O contêiner de exibição executa o servidor proxy, chamado nginx. Este é o contêiner ao qual o Cloud Run envia solicitações de entrada. Portanto, você precisa especificar a versão de HTTP e a porta do contêiner para entregá-las.

Console

Navegue até Implantar o serviço para ver as instruções completas do console.

YAML

No arquivo service.yaml, anexe o seguinte:

spec:
  containers:
    # A) Serving ingress container "nginx" listening at PORT 8080
    # Main entrypoint of multi-container service.
    # Source is stored in nginx_config secret in Secret Manager.
    # Any pings to this container will proxy over to hello container at PORT 8888.
    # https://cloud.google.com/run/docs/container-contract#port
    - image: nginx
      name: nginx
      ports:
        - name: http1
          containerPort: 8080
      resources:
        limits:
          cpu: 500m
          memory: 256Mi
      # Referencing declared volume below,
      # Declaring volume to mount in current ingress container's filesystem
      # https://cloud.google.com/run/docs/reference/rest/v2/Container#volumemount
      volumeMounts:
        - name: nginx-conf-secret
          readOnly: true
          mountPath: /etc/nginx/conf.d/
      startupProbe:
        timeoutSeconds: 240
        periodSeconds: 240
        failureThreshold: 1
        tcpSocket:
          port: 8080

O servidor nginx requer um arquivo de configuração no diretório /etc/nginx/conf.d/. Para fazer isso, monte um volume contendo o arquivo no local. A seção volumeMount especifica um volume chamado configuration a ser colocado lá. O próprio volume é definido em sua própria seção posteriormente no arquivo.

Console

Navegue até Implantar o serviço para ver as instruções completas do console.

YAML

Em service.yaml, anexe o seguinte:

- image: us-docker.pkg.dev/cloudrun/container/hello
  name: hello
  env:
    - name: PORT
      value: "8888"
  resources:
    limits:
      cpu: 1000m
      memory: 512Mi
  startupProbe:
    timeoutSeconds: 240
    periodSeconds: 240
    failureThreshold: 1
    tcpSocket:
      port: 8888

O aplicativo hello também precisa de informações de configuração. Ele detecta solicitações de entrada na porta especificada na variável de ambiente PORT. O nome e o valor são especificados na seção env.

Console

Navegue até Implantar o serviço para ver as instruções completas do console.

YAML

No arquivo service.yaml, anexe o seguinte:

volumes:
  - name: nginx-conf-secret
    secret:
      secretName: nginx_config
      items:
        - key: latest
          path: default.conf

Especifique a configuração volume ativada na seção volumeMount. Ela contém um único arquivo chamado nginx.conf, cujo conteúdo é definido como o valor do secret chamado nginx-conf-secret.

Console

1. Acesse a página do Cloud Run no Console do Google Cloud.

   Acesse o Cloud Run

2. Clique em Implantar contêiner e selecione Serviço para exibir o formulário Criar serviço.

   1. Selecione Implantar uma revisão de uma imagem de contêiner atual e insira nginx como URL da imagem do contêiner.
   2. No campo Nome do serviço, forneça um nome para o serviço, por exemplo, hello-mc.
   3. Na lista Região, selecione um local para implantar, por exemplo, us-west1.
   4. Em Autenticação, selecione Allow unauthenticated invocations. Se você não tiver permissões (função de administrador do Cloud Run) para selecionar essa opção, o serviço será implantado e exigirá autenticação.

3. Clique em Contêiner(es), volumes, rede, segurança para expandir o formulário de configuração.

   1. Clique na guia Volumes.
   2. Clique em Adicionar volume.
   3. Na lista Tipo de volume, selecione Secret.
   4. No campo Nome do volume, digite nginx-conf-secret.
   5. No campo Secret, insira nginx_config.
   6. Em Caminhos especificados para versões de secret, especifique default.conf como o caminho e latest como a versão.
   7. Clique em Criar para criar o volume do secret.

4. Clique na guia Contêineres para exibir o formulário Editar contêiner.

   1. Clique em Configurações e, em Recursos, altere a memória para 256MiB e a CPU para 1 CPU.
   2. Clique em Montagens de volumes.
   3. Clique em Montar volume.
   4. Selecione nginx-conf-secret na lista de nomes.
   5. Em Caminho de montagem, insira etc/nginx/conf.d.
   6. Clique em Concluído para finalizar a configuração do primeiro contêiner.

5. Clique em Adicionar contêiner para incluir o contêiner do arquivo secundário e exibir o formulário Novo contêiner.

   1. Selecione o URL da imagem do contêiner padrão us-docker.pkg.dev/cloudrun/container/hello
   2. Clique na guia Configurações e, em Recursos, mude a memória para 256MiB e a CPU para 1 CPU.
   3. Clique em Variáveis e secrets.
   4. Clique em Adicionar variável.
   5. Digite PORT como o novo nome da variável de ambiente e 8888 como o valor.
   6. Clique em Concluído.

6. Acesse o formulário Editar contêiner para o primeiro contêiner (nginx).

   1. Clique na guia Configurações.
   2. Em Ordem de inicialização do contêiner, selecione nginx na lista Depende de. Isso significa que o contêiner nginx é iniciado somente após a inicialização do contêiner hello.
   3. Clique em Criar e aguarde a implantação do serviço.

gcloud

Para implantar o contêiner do servidor proxy e o contêiner do app da Web como um único serviço:

gcloud run services replace service.yaml

gcloud

Para verificar a implantação, copie o URL do Cloud Run gerado e abra-o em um navegador ou use este comando para enviar uma solicitação autenticada:

curl --header "Authorization: Bearer $(gcloud auth print-identity-token)" 

Você verá um proxy nginx que foi transferido para o contêiner de arquivo secundário hello com status de resposta 200.

gcloud

1. Em um terminal, clone o repositório do app de exemplo na sua máquina local:

   git clone https://github.com/GoogleCloudPlatform/cloud-run-samples

2. Mude para o diretório que contém o código de amostra do Cloud Run:

   cd cloud-run-samples/multi-container/hello-nginx-sample/