O ambiente de execução do .NET

O ambiente de execução do .NET é a pilha de software responsável por instalar o código e as dependências do aplicativo e executá-lo no ambiente flexível.

Versões do .NET

O .NET 8 foi criado com buildpacks. Para ver a lista completa de versões compatíveis do .NET e a versão correspondente do Ubuntu, consulte a Programação de suporte ao ambiente de execução.

Para usar uma versão compatível do .NET, é preciso:

  • Atualize o arquivo do projeto com a versão do .NET que você quer usar.

    <Project Sdk="Microsoft.NET.Sdk.Web">
    
      <PropertyGroup>
        <TargetFramework>net8.0</TargetFramework>
        <Nullable>enable</Nullable>
        <ImplicitUsings>enable</ImplicitUsings>
      </PropertyGroup>
    
      <ItemGroup>
        <None Update="app.yaml">
          <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
        </None>
      </ItemGroup>
    
    </Project>
    

    Para mais informações, consulte Migrar do ASP.NET Core 3.1 para o 6.0.

  • Instalar a versão da CLI gcloud 420.0.0 ou posterior do Google Analytics. Para atualizar as ferramentas da CLI, execute o comando gcloud components update. Para conferir a versão instalada, execute o comando gcloud version.

  • Especifique a configuração operating_system no arquivo app.yaml:

      runtime: aspnetcore
      env: flex
    
      runtime_config:
          operating_system: "ubuntu22"
    
  • Como alternativa, é possível especificar uma versão de ambiente de execução incluindo a configuração runtime_version em app.yaml. Por padrão, o App Engine usa a versão mais recente do LTS .NET disponível se a configuração runtime_version não for especificada. Por exemplo, o arquivo app.yaml é semelhante ao seguinte ao especificar .NET 8 no Ubuntu 22:

      runtime: aspnetcore
      env: flex
    
      runtime_config:
          runtime_version: "8"
          operating_system: "ubuntu22"
    

Versões anteriores do ambiente de execução

Para direcionar uma versão específica do SDK .NET, atualize o arquivo do projeto. Para mais informações, consulte Migrar do ASP.NET Core 3.1 para a versão 6.0.

Se você quiser usar o GKE ou outros hosts do Docker, precisará criar um Dockerfile que copie o código do aplicativo e instale as dependências. Para mais informações, consulte Ambientes de execução personalizados.

Para implantar seu aplicativo .NET, execute os seguintes comandos no diretório raiz em que o aplicativo reside:

    dotnet restore
    dotnet publish -c Release
    gcloud app deploy

Compatibilidade com outros ambientes de execução .NET

Se você precisa usar uma versão do .NET que não é compatível, crie um ambiente de execução personalizado e selecione uma imagem de base válida com a versão .NET que você precisa.

Para imagens de base fornecidas pelo Google ou imagens de base do Docker .NET, consulte Como criar ambientes de execução personalizados.

HTTPS e proxies de encaminhamento

O App Engine encerra a conexão HTTPS no balanceador de carga e encaminha a solicitação ao aplicativo. Os aplicativos podem examinar o X-Forwarded-Proto para saber se o protocolo original era HTTP ou HTTPS.

Alguns aplicativos também precisam averiguar o endereço IP do usuário. Isso está disponível no cabeçalho X-Forwarded-For padrão.

Como ampliar o ambiente de execução

O ambiente flexível do ambiente de execução do .NET pode ser usado para criar um ambiente de execução personalizado. Os ambientes de execução personalizados são configurados por meio de Dockerfile.

É possível personalizar Dockerfile e .dockerignore conforme você quiser. Por fim, você precisará especificar runtime: custom em vez de runtime: aspnetcore em app.yaml. Para saber mais informações, consulte Como personalizar o ambiente de execução do .NET.

Variáveis de ambiente

As variáveis de ambiente a seguir são definidas pelo ambiente do ambiente de execução:

Variável de ambiente Descrição
GAE_INSTANCE O nome da instância atual.
GAE_MEMORY_MB A quantidade de memória disponível para o processo do aplicativo.
GAE_SERVICE O nome do serviço especificado no arquivo app.yaml do aplicativo. Se nenhum nome de serviço for especificado, será definido como default.
GAE_VERSION O rótulo da versão do aplicativo atual.
GOOGLE_CLOUD_PROJECT O ID do projeto associado ao seu aplicativo, que fica visível no Console do Google Cloud
PORT A porta que receberá as solicitações HTTP.

É possível definir outras variáveis de configuração com appsettings.json.

Servidor de metadados

Cada instância do aplicativo pode usar o servidor de metadados do Compute Engine para consultar informações sobre a instância, incluindo o nome do host, o endereço IP externo, o código da instância, os metadados personalizados e as informações sobre a conta do serviço. Não é possível definir metadados personalizados para cada instância no App Engine. Em vez disso, defina metadados personalizados para todo o projeto e leia esses metadados a partir das instâncias do App Engine e do Compute Engine.

A função de exemplo abaixo usa o servidor de metadados para receber o endereço IP externo da instância:

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Metadata-Flavor", new[] { "Google" });
response = await client.GetStringAsync(
    "http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/0/access-configs/0/external-ip");