Guia de início rápido para .NET no ambiente flexível do App Engine

Neste guia de início rápido, você aprenderá a criar um pequeno aplicativo do App Engine que exibe uma mensagem curta.

Antes de começar

Antes de executar e implantar este guia início rápido, instale o SDK do Cloud e 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:

    gcloud app create --project=[YOUR_PROJECT_ID]
    

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

  4. Verifique se o faturamento está ativado no projeto. É necessário que uma conta de faturamento esteja vinculada ao projeto para que o aplicativo seja implantado no App Engine.

    Ativar faturamento

    A implantação do ambiente flexível gerará custos enquanto estiver ativa. Limpe o projeto quando terminar para evitar custos contínuos.

  5. Instale os pré-requisitos a seguir:

Locais do App Engine

Como o App Engine é regional, a infraestrutura de execução dos aplicativos está localizada em uma determinada região e é gerenciada pelo Google. Assim, ela fica 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 aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do seu aplicativo, mas considere o local dos outros produtos e serviços do GCP usados pelo aplicativo. O uso de serviços em vários locais pode afetar a latência do aplicativo, além do preço.

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 (Norte da Virgínia)
  • 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á criou um aplicativo do App Engine, execute o comando gcloud app describe ou abra o Painel do App Engine no Console do GCP para ver a região. A região do aplicativo do App Engine está listada em http://[YOUR_PROJECT_ID].appspot.com.

Para seguir este guia de início rápido, você precisa estar familiarizado com a criação de aplicativos da Web com o C#.

Fazer o download do app Hello World

Criamos um app Hello World para .NET. Com ele, você tem uma ideia rápida de como implantar um app no Google Cloud Platform. O app Hello World é semelhante ao criado pelo Visual Studio quando um app vazio do ASP.NET Core é criado. O app de amostra adiciona um arquivo app.yaml. O app.yaml é um arquivo de configuração do App Engine. Nele, você especifica o ambiente de execução e outras configurações do App Engine.

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

    git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples
    

    Outra opção é fazer o download da amostra (em inglês) como um arquivo ZIP e extraí-la.

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

    cd dotnet-docs-samples/appengine/flexible/HelloWorld
    

Executar o Hello World na máquina local

Visual Studio

Siga as etapas abaixo para executar o aplicativo Hello World no seu computador local:

  1. Abra o arquivo dotnet-docs-samples\appengine\flexible\HelloWorld\HelloWorld.sln com o Visual Studio.
  2. Pressione F5.

    Você verá a mensagem "Hello World" do aplicativo de amostra exibida na página.

Linha de comando

Siga as etapas abaixo para executar o aplicativo Hello World no seu computador local:

  1. Execute os comandos a seguir no diretório dotnet-docs-samples\appengine\flexible\HelloWorld:
    dotnet restore
    dotnet run
  2. No seu navegador da Web, acesse http://localhost:5000/.

    Você verá a mensagem "Hello World" do aplicativo de amostra exibida na página.

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

Implantar e executar o Hello World no App Engine

Visual Studio

Siga as etapas abaixo para implantar o app Hello World:

  1. Abra o arquivo dotnet-docs-samples\appengine\flexible\HelloWorld\HelloWorld.sln com o Visual Studio.
  2. No "Gerenciador de Soluções", clique com o botão direito do mouse em HelloWorld e selecione Publicar no Google Cloud...
  3. Clique em App Engine Flex.
  4. Clique em Publicar.
  5. Para ver o aplicativo implantado, acesse o seguinte endereço no seu navegador:

    https://YOUR_PROJECT_ID.appspot.com

Linha de comando

  1. Execute os comandos a seguir no diretório dotnet-docs-samples\appengine\flexible\HelloWorld:

    dotnet restore
    dotnet publish -c Release
    gcloud app deploy .\bin\Release\netcoreapp2.1\publish\app.yaml
  2. Inicie o navegador e veja 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 em .NET no ambiente flexível do App Engine.

Veja as seções a seguir para informações sobre limpeza e links das próximas etapas.

Limpar

Exclua o projeto do GCP para não ser cobrado pelos recursos usados nele.

  1. No Console do GCP, acesse a página "Projetos".

    Acessar a página Projetos

  2. Na lista de projetos, selecione um e clique em Excluir projeto.
  3. Na caixa de diálogo, digite o código do projeto e clique em Encerrar para excluí-lo.

A seguir

Conheça a plataforma inteira

Agora que você sabe como é desenvolver e implantar aplicativos do App Engine, explore o restante do GCP. Você já tem instalado o SDK do Cloud, que fornece as ferramentas de interação com produtos como o Cloud SQL, o Cloud Storage, o Cloud Firestore e muito mais.

Para seguir um tutorial passo a passo sobre como criar um aplicativo que usa toda a plataforma, em vez de somente o App Engine, consulte nosso guia de início rápido sobre a criação do app Bookshelf.

Saiba mais sobre o ambiente flexível do App Engine

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

Revisão do código do Hello World

O Hello World é o app mais simples possível do App Engine. Nele, há apenas um serviço e uma versão, e todo o código é armazenado no diretório raiz. Cada arquivo do aplicativo é descrito em detalhes nesta seção.

Startup.cs

O app Hello World é um aplicativo ASP.NET simples:

    public class Startup
    {
        public Startup(IConfiguration configuration)
        {
            Configuration = configuration;
        }

        public IConfiguration Configuration { get; }

        // This method gets called by the runtime. Use this method to add services to the container.
        // For more information on how to configure your application, visit https://go.microsoft.com/fwlink/?LinkID=398940
        public void ConfigureServices(IServiceCollection services)
        {
        }

        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {
            if (env.IsDevelopment())
            {
                app.UseDeveloperExceptionPage();
            }

            app.Run(async (context) =>
            {
                string greeting = Configuration["My:Greeting"];
                await context.Response.WriteAsync(greeting);
            });
        }
    }

app.yaml

O arquivo app.yaml descreve a configuração de implantação do aplicativo:

runtime: aspnetcore
env: flex

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

env_variables:
  # The __ in My__Greeting will be translated to a : by ASP.NET.
  My__Greeting: Hello AppEngine!

Neste caso, app.yaml especifica o ambiente de execução usado pelo aplicativo e configura o env: flex, que determina o uso do ambiente flexível.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente flexível do App Engine para documentos .NET