存储和传送静态文件

除了处理动态请求之外，应用通常还需要传送静态文件（如 JavaScript、图片和 CSS）。标准环境中的应用可以通过 Google Cloud 产品（如 Cloud Storage）传送静态文件，也可以直接或使用第三方内容分发网络 (CDN) 传送这些文件。

从 Cloud Storage 传送文件

Cloud Storage 可为动态 Web 应用托管静态资源。与直接从应用传送内容相比，使用 Cloud Storage 进行传送可为您带来以下好处：

• Cloud Storage 实际起到内容分发网络的作用。这不需要任何特殊配置，因为默认情况下，任何可公开读取的对象都会在全球 Cloud Storage 网络中进行缓存。
• 将传送静态资源的工作转交给 Cloud Storage 处理，应用本身的负载将降低。根据您拥有的静态资源数量以及访问频率，这有可能大幅度降低应用的运行费用。
• 访问 Cloud Storage 内容的带宽费用通常较低。

您可以使用 Google Cloud CLI 或 Cloud Storage API 将资产上传到 Cloud Storage。

Google Cloud 客户端库为 Cloud Storage 提供了惯用的客户端，用于在 App Engine 应用中使用 Cloud Storage 存储和检索数据。

从 Cloud Storage 存储分区传送文件的示例

下面的示例创建了一个 Cloud Storage 存储桶，并使用 gcloud CLI 上传静态资源：

1. 创建存储分区。通常以项目 ID 命名存储分区（并非必需）。存储分区名称必须保持全局唯一。

   gcloud storage buckets create gs://<var>your-bucket-name</var>
   

2. 设置 IAM 政策以授予对存储桶中的项的公开读取权限。

   gcloud storage buckets add-iam-policy-binding gs://<var>your-bucket-name</var> --member=allUsers --role=roles/storage.objectViewer
   

3. 将内容上传到存储分区。rsync 命令通常是上传和更新资源最快速、最便捷的方法。此外，您也可以使用 cp。

   gcloud storage rsync ./static gs://<var>your-bucket-name</var>/static --recursive
   

现在，您可以通过 https://storage.googleapis.com/<var>your-bucket-name</var>/static/... 访问静态资源了。

如需详细了解如何使用 Cloud Storage 传送静态资源（包括如何从自定义域名进行传送），请参阅如何托管静态网站。

从其他 Google Cloud 服务传送文件

您还可以选择使用 Cloud CDN 或其他 Google Cloud 存储服务。

直接从您的应用传送文件

如需在标准环境中传送静态文件，请在 app.yaml 文件中使用 static_dir 或 static_files 元素定义处理程序。

静态文件或静态目录中的内容不受 app.yaml 文件中的扩缩设置的影响。对静态文件或静态目录的请求由 App Engine 基础架构直接处理，不会到达应用的语言运行时。

配置静态文件处理程序

如需将应用配置为从 /static 网址传送 ./public 目录，请在 app.yaml 文件中定义处理程序。

下面演示了如何传送示例应用 ./public 目录中的静态文件。此应用 index.html 页面的模板会指示浏览器加载 main.css 文件，例如：

<link type="text/css" rel="stylesheet" href="/static/css/main.css">

项目的 app.yaml 文件的 static_dir 元素中定义了 ./public 目录：

handlers:
  - url: /favicon\.ico
    static_files: favicon.ico
    upload: favicon\.ico

  - url: /static
    static_dir: public

  - url: /.*
    secure: always
    redirect_http_response_code: 301
    script: auto

上述示例中的 handlers 部分处理了三种网址格式：

• /favicon.ico 处理程序将专门针对 /favicon.ico 的请求映射到应用根目录中名为 favicon.ico 的文件。

• /static 处理程序映射针对以 /static 开头的网址的请求。当 App Engine 收到针对以 /static 开头的网址的请求时，它会将路径的其余部分映射到 ./public 目录中的文件。如果在该目录中找到了相应的文件，则该文件的内容会返回给客户端。

• /.* 处理程序匹配所有其他网址，并将它们定向到您的应用。

网址路径格式会按照其在 app.yaml 中出现的顺序进行测试，因此，您应在 /.* 格式前面定义静态文件的格式。如需了解详情，请参阅 app.yaml 参考文档。

请注意，如需使用静态处理程序，您必须在 app.yaml 中指定 entrypoint 元素，或者指定 script 设置为 auto 的处理程序。

从第三方内容分发网络进行传送

您可以使用任何外部第三方 CDN 传送静态文件并缓存动态请求，但您的应用可能会遇到延迟和费用增加的情况。

为了提升性能，您应该使用支持 CDN Interconnect 的第三方 CDN。