O SDK para Java do Google App Engine inclui um comando para interagir com o Google App Engine. É possível usar esse comando para enviar versões novas do código e dos arquivos de configuração e estáticos do seu aplicativo para o Google App Engine. Você também pode usar o comando para gerenciar os índices do armazenamento de dados e fazer o download de dados do registro.
Se você estiver usando o Eclipse e o plug-in do Google, é possível enviar o seu aplicativo diretamente do Eclipse. Para enviar o aplicativo, clique no botão de implementação do Google App Engine na barra de ferramentas: 
Para obter mais informações, consulte Plug-in do Google para o Eclipse.
Você também pode enviar o seu aplicativo a partir de um prompt de comando. Para usar os outros recursos do comando, como o download de registros, execute o comando a partir do prompt de comando. O comando a ser executado está no diretório appengine-java-sdk/bin/ do SDK.
Se você estiver usando o Windows, este é o comando:
appengine-java-sdk\bin\appcfg.cmd [options] <action> <war-location>
Se você estiver usando o Mac OS X ou o Linux, este é o comando:
./appengine-java-sdk/bin/appcfg.sh [options] <action> <war-location>
O comando assume como argumentos o nome de uma ação a ser executada e a localização do diretório WAR do seu aplicativo.
Para enviar um aplicativo, use a ação update, como mostrado abaixo:
./appengine-java-sdk/bin/appcfg.sh update myapp/war
Esses comandos são scripts do empacotador específicos do sistema operacional e que executam a classe Java com.google.appengine.tools.admin.AppCfg em appengine-java-sdk/lib/appengine-tools-api.jar.
Ao enviar um aplicativo usando a ação update, a atualização inclui a configuração de índice do aplicativo (os arquivos datastore-indexes.xml e generated/datastore-indexes-auto.xml). Se a configuração do índice definir um índice que ainda não existe no Google App Engine, o Google App Engine criará o índice novo. Dependendo do número de dados já armazenados no armazenamento de dados que precisam ser mencionados no índice novo, o processo de criação do índice pode demorar um pouco. Se o aplicativo executar uma consulta que exige um índice que ainda está em fase de construção, a consulta emitirá uma exceção.
Para evitar isso, certifique-se de que a versão nova do aplicativo que exige um índice novo não é a versão ativa do aplicativo até que os índices terminem de ser criados. Uma maneira de fazê-lo é dar ao aplicativo um número novo de versão em appengine-web.xml sempre que adicionar ou alterar um índice na configuração. O aplicativo é enviado como uma versão nova e não se torna a versão padrão automaticamente. Quando a criação dos índices terminar, altere a versão padrão para a nova usando a seção "Versions" (Versões) do Console de administração.
Outra forma de garantir que os índices novos sejam criados antes que o novo aplicativo seja realmente executado é enviar a configuração do índice separadamente antes de enviar o aplicativo. Para enviar apenas a configuração do índice de um aplicativo, use a ação update_indexes:
./appengine-java-sdk/bin/appcfg.sh update_indexes myapp/war
Você pode verificar o status dos índices do aplicativo na seção "Indexes" (Índices) do Console de administração.
O Google App Engine oferece suporte às tarefas programadas (conhecidas como trabalhos do cron). Elas são especificadas em um arquivo chamado cron.xml e enviadas usando o comando update_cron:
./appengine-java-sdk/bin/appcfg.sh update_cron myapp/war
appcfg update também enviará as especificações dos trabalhos do cron se o arquivo existir. Para obter mais informações sobre os trabalhos do cron, consulte a documentação dos Trabalhos do cron.
O Google App Engine mantém um registro das mensagens emitidas pelo seu aplicativo. Ele também grava cada solicitação no registro. Para navegar nos registros do aplicativo, use a seção "Logs" (Registros) do Console de administração.
Se você quiser analisar esses registros mais detalhadamente, faça o download dos dados de registro para um arquivo no seu computador. Para fazer o download para um arquivo chamado mylogs.txt, use a ação request_logs, como mostrado a seguir:
./appengine-java-sdk/bin/appcfg.sh request_logs myapp/war mylogs.txt
Por padrão, o comando faz o download das mensagens de registro do dia atual (a partir da meia-noite do horário do Pacífico) com o nível de registro de INFO ou superior (omitindo as mensagens do nível DEBUG). O comando substitui o arquivo de registro local. Você pode ajustar o número de dias, o nível mínimo de registro e se o arquivo de registro local deve ser substituído ou anexado usando as opções da linha de comando. Veja abaixo para obter mais informações sobre essas opções.
O comando AppCfg aceita um conjunto de opções, uma ação e argumentos para a ação.
Estão disponíveis as seguintes ações:
|
appcfg.sh [options] update <war-location>Envia os arquivos de um aplicativo de acordo com o diretório raiz do aplicativo. O ID e a versão do aplicativo são obtidas do arquivo appengine-web.xml.
appcfg.sh [options] rollback <war-location>Desfaz uma atualização parcialmente concluída do aplicativo especificado. Use essa opção se uma atualização foi interrompida e se o comando relatar que o aplicativo não pode ser atualizado devido a um bloqueio.
appcfg.sh [options] update_indexes <war-location>Atualiza os índices do armazenamento de dados no Google App Engine para incluir os índices adicionados recentemente. Se a nova versão do seu aplicativo exigir uma definição de índice adicional que foi adicionada à configuração de índice, você pode atualizar a sua configuração de índice no Google App Engine antes de enviar a nova versão do seu aplicativo. A execução dessa ação algumas horas antes do envio da nova versão do seu aplicativo dará tempo para os índices serem criados e oferecidos quando o aplicativo for implementado.
appcfg.sh [options] request_logs <war-location> <output-file>Recupera os dados de registro do aplicativo sendo executado no Google App Engine. output-file é o nome do arquivo a ser criado ou substituído. Se output-file for um hífen (-), os dados de registro serão impressos no console. As opções abaixo são aplicáveis a request_logs:
--num_days=...O número de dias de dados de registro a serem recuperados, terminando na data atual à meia-noite UTC. O valor 0 recupera todos os registros disponíveis. Se --append for fornecido, o padrão é 0. Caso contrário, o padrão é 1.
--severity=...O nível de registro mínimo das mensagens de registro a serem recuperadas. O valor é um número correspondente ao nível de registro: 4 para CRITICAL, 3 para ERROR, 2 para WARNING, 1 para INFO, 0 para DEBUG. Todas as mensagens do nível de registro fornecido e acima serão recuperadas. O padrão é 1 (INFO).
appcfg.sh [options] help <war-location>Imprime uma mensagem de ajuda sobre a ação especificada e sai em seguida.
O comando AppCfg aceita as opções abaixo para todas as ações:
--email=...O endereço de e-mail da conta do Google de um administrador do aplicativo, para ações que exigem login. Se for omitido e nenhum cookie tiver sido armazenado na última vez que o comando foi executado, o comando solicitará esse valor.
--server=...O nome do host do servidor do Google App Engine. O padrão é appengine.google.com.
--host=...O nome do host da máquina local para uso com chamadas remotas de procedimento.
--sdk_root=...Um caminho para o SDK para Java do Google App Engine, se for diferente da localização da ferramenta.
--passinNão armazena as credenciais de login do administrador como um cookie. Solicita uma senha todas as vezes.