Como migrar para a CLI gcloud

Python 2.7/3 |Java 8/Java 11/17 |PHP 5/7+ |Ruby |Go 1.11 / 1.12+ |Node.js

O SDK independente do App Engine foi suspenso em 30 de julho de 2019 e agora está desativado. A tabela a seguir lista os recursos e as alternativas recomendadas:

Suspenso	Ação recomendada
SDK independente do App Engine	Fazer o download da Google Cloud CLI
Acesse APIs legadas do App Engine usando o SDK do App Engine	Migre para um serviço desagrupado do Google Cloud ou de terceiros ou acesse os serviços incluídos usando o SDK de serviços do App Engine se estiver usando um ambiente de execução de segunda geração
appcfg commands	Migrar do AppCfg para a linha de comando do gcloud
dev_appserver.sh commands	Para desenvolvimento local, execute o comando java_dev_appserver.sh no diretório bin da CLI gcloud
Plug-in Java baseado no SDK do App Engine para Maven (com.google.appengine.appengine-maven)	Migrar para o plug-in Maven baseado na CLI gcloud
Plug-in baseado em Java do App Engine para Gradle (com.google.appengine.appengine-gradle)	Migrar para o plug-in Gradle baseado na CLI gcloud
Formatos de arquivo cron.xml, datastore-index.xml, dispatch.xml e queue.xml	Migre automaticamente usando a ferramenta gcloud beta app migrate-config ou migre seus arquivos xml para yaml manualmente.

Cronograma de migração

30 de julho de 2019: o uso das ferramentas com base no SDK independente do App Engine foi suspenso.

30 de agosto de 2020: o Google encerrou e removeu o suporte ao SDK independente do App Engine.

30 de agosto de 2020: o Google encerrou e removeu o suporte ao SDK independente do App Engine.

Recursos não compatíveis com versões anteriores

Como resultado da suspensão de uso da ferramenta appcfg e do SDK independente do App Engine, os recursos a seguir não são suportados na CLI gcloud no momento:

• Downloads dos arquivos de seu aplicativo com o AppCfg

Como migrar formatos de arquivo XML para YAML

A CLI gcloud não suporta os seguintes formatos de arquivo:

• cron.xml
• datastore-index.xml
• dispatch.xml
• queue.xml

Os exemplos a seguir demonstram como migrar seus arquivos xml para yaml.

Como migrar arquivos automaticamente

Beta

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para migrar seus arquivos xml automaticamente:

1. É preciso ter a CLI gcloud versão 226.0.0 ou mais recente. Se quiser atualizar para a versão mais recente:

   gcloud components update
   

2. Para cada arquivo que você quer migrar, especifique um dos seguintes subcomandos (cron-xml-to-yaml, datastore-indexes-xml-to-yaml, dispatch-xml-to-yaml, queue-xml-to-yaml) e o nome do arquivo:

   gcloud beta app migrate-config queue-xml-to-yaml MY-QUEUE-XML-FILE.xml
   

3. Verifique mais uma vez manualmente o arquivo convertido antes de implantar no ambiente de produção.

   Para uma amostra de conversão de arquivo xml em yaml, consulte as guias em Como migrar seus arquivos manualmente.

Como migrar arquivos manualmente

Para migrar manualmente seus arquivos xml para yaml:

cron.yaml

Crie um arquivo cron.yaml com um objeto cron que contenha uma lista de objetos, cada um com campos que correspondem a cada um dos atributos de tag <cron> no seu arquivo cron.xml, conforme mostrado abaixo.

Arquivo cron.yaml convertido:

cron:
- url: '/recache'
  schedule: 'every 2 minutes'
  description: 'Repopulate the cache every 2 minutes'
- url: '/weeklyreport'
  schedule: 'every monday 08:30'
  target: 'version-2'
  timezone: 'America/New_York'
  description: 'Mail out a weekly report'

Arquivo cron.xml original

<?xml version="1.0" encoding="UTF-8"?>
<cronentries>
  <cron>
    <url>/recache</url>
    <description>Repopulate the cache every 2 minutes</description>
    <schedule>every 2 minutes</schedule>
  </cron>
  <cron>
    <url>/weeklyreport</url>
    <description>Mail out a weekly report</description>
    <schedule>every monday 08:30</schedule>
    <timezone>America/New_York</timezone>
    <target>version-2</target>
  </cron>
</cronentries>

Para mais informações, consulte a documentação de referência do cron.yaml.

dispatch.yaml

Crie um arquivo dispatch.yaml com um objeto dispatch que contenha uma lista de objetos, cada um com campos que correspondem a cada um dos atributos de tag <dispatch> no seu arquivo dispatch.xml, conforme mostrado abaixo.

Arquivo dispatch.yaml convertido:

dispatch:
- url: '*/favicon.ico'
  module: default
- url: 'simple-sample.uc.r.appspot.com/'
  module: default
- url: '*/mobile/*'
  module: mobile-frontend

Arquivo dispatch.xml original

<?xml version="1.0" encoding="UTF-8"?>
<dispatch-entries>
  <dispatch>
      <url>*/favicon.ico</url>
      <module>default</module>
  </dispatch>
  <dispatch>
      <url>simple-sample.uc.r.appspot.com/</url>
      <module>default</module>
  </dispatch>
  <dispatch>
      <url>*/mobile/*</url>
      <module>mobile-frontend</module>
  </dispatch>
</dispatch-entries>

Para mais informações, consulte a documentação de referência do dispatch.yaml.

index.yaml

Crie um arquivo index.yaml com um objeto indexes contendo uma lista de objetos, cada um com campos que correspondem a cada um dos atributos de tag <datastore-index> no seu arquivo datastore-indexes.xml, conforme mostrado abaixo.

Arquivo index.yaml convertido:

indexes:
- ancestor: false
  kind: Employee
  properties:
  - direction: asc
    name: lastName
  - direction: desc
    name: hireDate
- ancestor: false
  kind: Project
  properties:
  - direction: asc
    name: dueDate
  - direction: desc
    name: cost

Arquivo datastore-index.xml original

<?xml version="1.0" encoding="utf-8"?>
<datastore-indexes
 autoGenerate="true">
   <datastore-index kind="Employee" ancestor="false">
       <property name="lastName" direction="asc" />
       <property name="hireDate" direction="desc" />
   </datastore-index>
   <datastore-index kind="Project" ancestor="false">
       <property name="dueDate" direction="asc" />
       <property name="cost" direction="desc" />
   </datastore-index>
</datastore-indexes>

Para mais informações, consulte a documentação de referência do index.yaml.

queue.yaml

Crie um arquivo queue.yaml com um objeto queue que contenha uma lista de objetos, cada um com campos que correspondem a cada um dos atributos de tag <queue> no seu arquivo queue.xml, conforme mostrado abaixo.

Arquivo queue.yaml convertido:

queue:
- name: fooqueue
  mode: push
  rate: 1/s
  retry_parameters:
    task_retry_limit: 7
    task_age_limit: 2d
- name: barqueue
  mode: push
  rate: 1/s
  retry_parameters:
    min_backoff_seconds: 10
    max_backoff_seconds: 200
    max_doublings: 0

Arquivo queue.xml original

<queue-entries>
  <queue>
    <name>fooqueue</name>
    <rate>1/s</rate>
    <retry-parameters>
      <task-retry-limit>7</task-retry-limit>
      <task-age-limit>2d</task-age-limit>
    </retry-parameters>
  </queue>
  <queue>
    <name>barqueue</name>
    <rate>1/s</rate>
    <retry-parameters>
      <min-backoff-seconds>10</min-backoff-seconds>
      <max-backoff-seconds>200</max-backoff-seconds>
      <max-doublings>0</max-doublings>
    </retry-parameters>
  </queue>
<queue-entries>

Cuidado: a criação de filas para o serviço de fila de tarefas também pode ser gerenciada usando os métodos de gerenciamento de filas disponíveis por meio da API Cloud Tasks. No entanto, a combinação do método queue.yaml com os métodos de gerenciamento de filas pode produzir resultados inesperados e não é recomendada. Para mais informações, consulte Como usar o gerenciamento de filas versus queue.yaml.