Migrar um app de ambiente flexível do App Engine para o Cloud Run

Implantar imagens de contêiner

Se os serviços do App Engine forem implantados com um contêiner criado manualmente, será possível usar a mesma imagem de contêiner para implantar o serviço no Cloud Run. Para implantar a imagem do contêiner do App Engine no Cloud Run:

1. Anote o URL do registro em que a imagem do contêiner está localizada. Esse é o mesmo URL fornecido na sinalização --image-url ao implantar no App Engine.

2. Implante a imagem do contêiner:

   Console

   1. No console do Google Cloud, acesse a página do Cloud Run.

      Acesse o Cloud Run

   2. Clique em Criar serviço.

   3. Clique no botão Selecionar no campo URL da imagem do contêiner e escolha a imagem do contêiner que você implantou no App Engine.

   4. Digite um nome para o serviço. Escolha um nome exclusivo que represente o aplicativo que você está implantando.

   5. Na seção Autenticação, selecione Permitir invocações não autenticadas.

   6. É preciso criar as mesmas variáveis de ambiente para o Cloud Run que você definiu noapp.yaml do aplicativo do App Engine. Amplie as seções Contêiner, rede, segurança e crie as seguintes variáveis de ambiente clicando em Adicionar variável em Variáveis de ambiente:

      • Para soquetes Unix, adicione:

          INSTANCE_UNIX_SOCKET: /cloudsql/INSTANCE_CONNECTION_NAME
        

      • Para conectores do Cloud SQL, adicione:

          INSTANCE_CONNECTION_NAME:INSTANCE_CONNECTION_NAME
        

        Substitua INSTANCE_CONNECTION_NAME pelo ID do projeto, região e instância seguindo o formato de project:region:instance-id. É possível encontrá-lo na página Visão geral da instância no console do Google Cloud.

        Essas conexões são criptografadas automaticamente sem qualquer configuração extra.

      • DB_NAME: nome do banco de dados.

      • DB_USER: nome de usuário do seu usuário do banco de dados.

      • DB_PASS: senha especificada ao criar o banco de dados.

   7. Na seção Conexões do Cloud SQL, clique no botão Adicionar conexão e selecione a instância criada anteriormente para o App Engine.

   8. Clique em Implantar. Depois que o serviço do Cloud Run for implantado, a página Detalhes do serviço exibirá um URL na parte superior da página. Clique no link URL para ver o app de amostra implantado no Cloud Run conectado ao Cloud SQL.

   gcloud

   Execute o comando a seguir para criar um novo serviço no Cloud Run.É necessário definir sinalizações de configuração para incluir as mesmas variáveis de ambiente de conexão SQL definidas no arquivo app.yaml do aplicativo do App Engine:

   gcloud run deploy run-sql --image IMAGE \
     --allow-unauthenticated \
     --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
     --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
     --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
     --set-env-vars DB_NAME="DB_NAME" \
     --set-env-vars DB_USER="DB_USER" \
     --set-env-vars DB_PASS="DB_PASS"
   

   Substitua:

   • IMAGE pela imagem que você está implantando;

   • INSTANCE_CONNECTION_NAME pelo nome da conexão da instância do Cloud SQL ou uma lista de nomes de conexões separados por vírgulas. Para encontrar o INSTANCE_CONNECTION_NAME, execute:

       gcloud instances describe INSTANCE_NAME
     

   • DB_NAME pelo nome do banco de dados.

   • DB_USER pelo nome de usuário do banco de dados.

   • DB_PASS pela senha do usuário do banco de dados.

Implantar código-fonte

O Cloud Run usa internamente os buildpacks e o Cloud Build para criar automaticamente imagens de contêiner do seu código-fonte, sem a necessidade de criar manualmente um contêiner ou especificar um Dockerfile. No entanto, se um Dockerfile estiver presente, ele será usado.

A implantação de um serviço do Cloud Run a partir da origem usa o Artifact Registry. Portanto, esse recurso só está disponível em regiões compatíveis com o Artifact Registry.

Para implantar o mesmo código-fonte implantado anteriormente no App Engine, faça o seguinte:

1. Mude para o diretório de origem do código-fonte do seu aplicativo.

     cd YOUR_APPENGINE_CODE_DIR
   

2. Implantar no Cloud Run

   Para criar o código-fonte e implantar o aplicativo, execute o comando de implantação com a sinalização --source. Defina as sinalizações de configuração para incluir as mesmas variáveis de ambiente de conexão SQL definidas no arquivo app.yaml do aplicativo do App Engine:

     gcloud run deploy run-sql --source SOURCE \
       --allow-unauthenticated \
       --add-cloudsql-instances INSTANCE_CONNECTION_NAME\
       --set-env-vars INSTANCE_UNIX_SOCKET="/cloudsql/INSTANCE_CONNECTION_NAME" \
       --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
       --set-env-vars DB_NAME="DB_NAME" \
       --set-env-vars DB_USER="DB_USER" \
       --set-env-vars DB_PASS="DB_PASS"
   

   Substitua:

   • SOURCE pelo caminho para o diretório de origem do App Engine.
   • INSTANCE_CONNECTION_NAME pelo nome da conexão da instância do Cloud SQL ou uma lista de nomes de conexões separados por vírgulas. Para encontrar o INSTANCE_CONNECTION_NAME, execute:

       gcloud instances describe INSTANCE_NAME
   

   • DB_NAME pelo nome do banco de dados.
   • DB_USER pelo nome de usuário do banco de dados.
   • DB_PASS pela senha do usuário do banco de dados.

3. Quando solicitado, insira um nome para o SERVICE.

4. Responda a todas as solicitações para instalar as APIs necessárias respondendo ao y quando solicitado. Você só precisa fazer isso uma vez para um projeto. Aguarde a conclusão da criação e da implantação. Quando terminar, uma mensagem semelhante a esta será exibida:

   Service [my-app] revision [my-app-00000-xxx] has been deployed and is serving 100 percent of traffic. Service URL: https://sample.run.app
   

   Para saber mais sobre como implantar código-fonte no Cloud Run, consulte Como implantar a partir do código-fonte.