.NET 运行时

.NET 运行时是负责安装应用代码和依赖项,然后在柔性环境中运行该应用的软件栈。

.NET 版本

.NET 8 使用 buildpack 构建。如需查看受支持的 .NET 版本及其对应 Ubuntu 版本的完整列表,请参阅运行时支持时间表

如需使用受支持的 .NET 版本,您必须:

  • 使用要使用的 .NET 版本更新项目文件。

    <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>
    

    如需了解详情,请参阅从 ASP.NET Core 3.1 迁移到 6.0

  • 安装 gcloud CLI 420.0.0 版或更高版本。您可以通过运行 gcloud components update 命令来更新 CLI 工具。如需查看已安装的版本,您可以运行 gcloud version 命令。

  • app.yaml 文件中指定 operating_system 设置:

      runtime: aspnetcore
      env: flex
    
      runtime_config:
          operating_system: "ubuntu22"
    
  • (可选)您可以通过在 app.yaml 文件中添加 runtime_version 设置来指定运行时版本。默认情况下,如果未指定 runtime_version 设置,App Engine 会使用可用的最新 LTS .NET 版本。例如,在 Ubuntu 22 上指定 .NET 8 时,app.yaml 文件如下所示:

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

过往运行时版本

如需以特定 .NET SDK 版本为目标,请更新项目文件。如需了解详情,请参阅从 ASP.NET Core 3.1 迁移到 6.0

如果您要使用 GKE 或其他 Docker 主机,则需要创建一个 Dockerfile 来复制应用代码并安装依赖项。如需了解详情,请参阅自定义运行时

如需部署 .NET 应用,请从应用所在的根目录运行以下命令:

    dotnet restore
    dotnet publish -c Release
    gcloud app deploy

对其他 .NET 运行时的支持

如果您需要使用不受支持的 .NET 版本,可以创建自定义运行时,并选择具有所需 .NET 版本的有效基础映像。

对于 Google 提供的基础映像或 Docker .NET 基础映像,请参阅构建自定义运行时

HTTPS 和转发代理

App Engine 会在负载均衡器上终止 HTTPS 连接,并将请求转发给应用。应用可以检查 X-Forwarded-Proto 来获悉原始协议是 HTTP 还是 HTTPS。

某些应用还需要确定用户的 IP 地址。该地址可在标准 X-Forwarded-For 标头中获取。

扩展运行时

柔性环境 .NET 运行时可用于创建自定义运行时。 自定义运行时是通过 Dockerfile 配置的。

您可以根据需要自定义 Dockerfile.dockerignore。最后,您将需要在 app.yaml 文件中指定 runtime: custom,而不是 runtime: aspnetcore。如需了解详情,请参阅自定义 .NET 运行时

环境变量

以下环境变量由运行时环境设置:

环境变量 说明
GAE_INSTANCE 当前实例的名称。
GAE_MEMORY_MB 可供应用进程使用的内存量。
GAE_SERVICE 在应用的 app.yaml 文件中指定的服务名称,如果未指定服务名称,则设置为 default
GAE_VERSION 当前应用的版本标签。
GOOGLE_CLOUD_PROJECT 与您的应用关联的项目 ID,可在 Google Cloud 控制台中查看
PORT 将接收 HTTP 请求的端口。

您可以使用 appsettings.json 设置其他配置变量。

元数据服务器

应用的每个实例都可以使用 Compute Engine 元数据服务器来查询有关实例的信息,包括实例的主机名、外部 IP 地址、实例 ID、自定义元数据和服务账号信息。App Engine 不允许为每个实例设置自定义元数据,但您可以设置项目级的自定义元数据,并从 App Engine 和 Compute Engine 实例中读取这些元数据。

此示例函数使用元数据服务器来获取实例的外部 IP 地址:

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");