Guia de início rápido do Python 8 no ambiente padrão do App Engine

Neste guia de início rápido, você verá como implantar um app de amostra no App Engine. Se você quiser saber mais sobre como codificar um app para o App Engine, consulte Como criar um app.

Custos

Não há custos associados à execução deste guia. A execução deste aplicativo de amostra não excede sua cota gratuita.

Antes de começar

Neste início rápido, presume-se que você já instalou o Java SE 8 Development Kit (JDK).

Antes de executar e implantar este início rápido, instale o SDK do Cloud e, em seguida, configure um projeto do GCP para o App Engine:

  1. Faça o download e instale o SDK do Cloud:

    Fazer o download do SDK

    Observação: se o SDK do Cloud já estiver instalado, atualize-o executando o comando a seguir:

    gcloud components update
    
  2. Crie um novo projeto:

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Verifique se o projeto foi criado:

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Você verá detalhes do projeto parecidos com o seguinte:

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. Inicialize seu aplicativo do App Engine com o projeto e escolha a região dele:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

    Quando solicitado, selecione a região em que o aplicativo do App Engine será armazenado.

  4. Instale os seguintes pré-requisitos:

Locais do App Engine

Como o App Engine é regional, a infraestrutura que executa os aplicativos está localizada em uma região específica e é gerenciada pelo Google para que esteja disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos seus aplicativos. Em geral, você escolhe a região mais próxima dos usuários do aplicativo. No entanto, pense também no local dos outros produtos e serviços do GCP utilizados pelo aplicativo. O uso de serviços em vários locais pode afetar a latência e o preço do seu aplicativo.

O App Engine está disponível nas regiões a seguir:

  • northamerica-northeast1 (Montreal)
  • us-central (Iowa)
  • us-west2 (Los Angeles)
  • us-east1 (Carolina do Sul)
  • us-east4 (Virgínia do Norte)
  • southamerica-east1 (São Paulo)
  • europe-west (Bélgica)
  • europe-west2 (Londres)
  • europe-west3 (Frankfurt)
  • europe-west6 (Zurique)
  • asia-northeast1 (Tóquio)
  • asia-northeast2 (Osaka)
  • asia-east2 (Hong Kong)
  • asia-south1 (Mumbai)
  • australia-southeast1 (Sydney)

Não é possível alterar a região de um aplicativo depois de defini-la.

Se você já tiver criado um aplicativo do App Engine, para ver a região, execute o comando gcloud app describe ou abra o Painel do App Engine no Console do GCP. A região do aplicativo do App Engine está listada em http://[YOUR_PROJECT_ID].appspot.com.

Como fazer o download do app Hello World

Criamos um aplicativo simples, Hello World, para o Java 8 Runtime. Com ele, você tem uma ideia rápida da implantação de um aplicativo no ambiente padrão do App Engine.

Faça o download do app de amostra e navegue para o diretório dele:

  1. Clone o repositório do app de amostra Hello World na máquina local:

    git clone https://github.com/GoogleCloudPlatform/getting-started-java.git
    

    Outra opção é fazer o download da amostra como um arquivo zip e extraí-lo.

  2. Acesse o diretório que contém o código de amostra:

    cd getting-started-java/appengine-standard-java8/helloworld
    

Como executar o Hello World na máquina local

Para executar o aplicativo Hello World no computador local:

  1. Inicie o servidor da Web local Jetty usando o plug-in Jetty Maven:

    mvn appengine:run
    
  2. No navegador da Web, acesse o seguinte endereço:

    http://localhost:8080
    
  3. Você verá a mensagem Hello World do app de amostra na página.

  4. Na janela de terminal, pressione Ctrl+C para sair do servidor da Web.

Como implantar e executar o Hello World no App Engine

Para implantar o aplicativo no ambiente flexível do App Engine, siga estas etapas:

  1. Implante o aplicativo Hello World executando o seguinte comando a partir do diretório getting-started-java/appengine-standard-java8/helloworld:
    mvn appengine:deploy
    Aguarde a conclusão da implantação.
  2. Inicie o navegador e execute o comando a seguir para ver o aplicativo em http://YOUR_PROJECT_ID.appspot.com:
    gcloud app browse

Nesse momento, a página que exibe a mensagem Hello World é enviada por um servidor da Web executado em uma instância do App Engine.

Parabéns! Você implantou seu primeiro aplicativo Java 8 no ambiente padrão do App Engine!

Consulte as seções a seguir para informações sobre como fazer a limpeza e links para as próximas etapas.

Próximas etapas

Conheça a plataforma inteira

Agora que você já sabe como é desenvolver e implantar aplicativos no App Engine, você pode expandir seus horizontes e conhecer o restante do Google Cloud Platform. Você já instalou o Google Cloud SDK, que lhe fornece as ferramentas necessárias para interagir com outros produtos, como o Google Cloud SQL, o Google Cloud Storage, o Google Cloud Datastore e muito mais. Para ver instruções orientadas sobre como criar um aplicativo que usa a plataforma toda, em vez de somente o App Engine, confira nosso início rápido sobre a criação do aplicativo Bookshelf.

Saiba mais sobre o ambiente padrão do App Engine

Veja abaixo alguns tópicos para você continuar aprendendo sobre o App Engine.

Revisão do código do app Hello World

Hello World é o app mais simples possível do App Engine. Nele, há apenas um serviço, uma versão e o código inteiro é armazenado no diretório raiz. Nesta seção, você verá uma descrição detalhada dos arquivos do app.

HelloAppEngine.java

O arquivo HelloServlet.java contém a especificação de um padrão de URL que descreve o local em que o aplicativo escutará solicitações e responde a todas elas com a mensagem “Hello World”.

import com.google.appengine.api.utils.SystemProperty;

import java.io.IOException;
import java.util.Properties;

import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

// With @WebServlet annotation the webapp/WEB-INF/web.xml is no longer required.
@WebServlet(name = "HelloAppEngine", value = "/hello")
public class HelloAppEngine extends HttpServlet {

  @Override
  public void doGet(HttpServletRequest request, HttpServletResponse response)
      throws IOException {
    Properties properties = System.getProperties();

    response.setContentType("text/plain");
    response.getWriter().println("Hello App Engine - Standard using "
            + SystemProperty.version.get() + " Java "
            + properties.get("java.specification.version"));
  }

  public static String getInfo() {
    return "Version: " + System.getProperty("java.version")
          + " OS: " + System.getProperty("os.name")
          + " User: " + System.getProperty("user.name");
  }

}
  • Para mais informações sobre como o Java 8 Runtime funciona, consulte Java 8 Runtime.

pom.xml

O Hello World também inclui um arquivo pom.xml, que contém informações sobre o projeto, como dependências e a meta de criação, incluindo as linhas necessárias para usar o plug-in Maven:

<plugin>
  <groupId>com.google.cloud.tools</groupId>
  <artifactId>appengine-maven-plugin</artifactId>
  <version>1.3.1</version>
</plugin>

appengine-web.xml

O arquivo appengine-web.xml contém certas configurações necessárias, como a configuração java8 para o elemento <runtime> que instrui o App Engine a executar este aplicativo no Java 8 Runtime:

<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <runtime>java8</runtime>
  <threadsafe>true</threadsafe>
</appengine-web-app>
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Java 8