在 Microsoft Azure 上运行 Metabase

本指南介绍了使用 Docker 在 Microsoft Azure 中运行 Metabase 实例的基础知识。

步骤 1：创建资源组（资源分组）

在 Azure 管理控制台中，单击页面顶部的资源组图标（或直接搜索资源组）。如果您已有资源组，可以直接跳到步骤 2。

在资源组页面，单击顶部栏中的+ 添加按钮以创建新资源组。在创建资源组页面，选择您的有效 Azure 订阅，输入您的资源组名称，然后选择一个区域。

单击下一步，直到您看到创建按钮，然后单击它。

选择 Metabase 的区域时，您应考虑您的用户和数据仓库的位置，以及可能限制跨境数据传输的基础设施成本和隐私法规。

步骤 2：创建 VNET（虚拟网络）

在页面中心，单击创建资源按钮。搜索 VNET

选择 Microsoft 的 VNET 产品，然后单击创建

输入虚拟网络的名称并选择与资源组相同的区域。单击底部的下一步：IP 地址按钮。

在这里，我们将创建一个由公共子网（暴露在互联网上的网络）和私有网络（包含您的应用程序数据库）组成的安全网络。

在 IPv4 地址中，您应该有一个默认值 10.0.0.0/16（否则将该网络空间添加到框中）。接下来，添加两个子网

• 一个名为 public 的子网，子网地址范围为 10.0.1.0/24，以及
• 一个名为 private 的子网，子网范围为 10.0.2.0/24。

单击下一步，直到您到达审阅和创建页面，然后单击底部的创建按钮以创建您的网络。

步骤 3：创建应用程序数据库 (PostgreSQL)

从 Azure 管理控制台主页，创建一个新资源。这次搜索 Azure Database for PostgreSQL。您也可以在数据库下的市场菜单中找到此数据库。

在下一页，您需要选择使用服务的方式。现在选择单一服务器是一个很好的起点，但请注意，这将只创建一个 PostgreSQL 实例，它将是您的单点故障。

在下一屏幕上，选择或输入以下内容

• 资源组：您包含所有组件的资源组。
• 服务器名称：数据库的唯一名称。
• 数据源：可以保留为None。
• 位置：与您的资源组和 VNET 使用相同的位置。
• 版本：使用您可以使用的最新版本。
• 计算 + 存储：您可以重新调整数据库的大小，但必须选择通用层，因为它是唯一提供私有链接的层。

然后选择您选择的管理员用户名和密码。

单击下一步，直到您到达最后一页，然后单击创建。Azure 需要一些时间来创建数据库。创建完成后，单击转到资源按钮。

步骤 4：创建私有端点连接

在 Azure for PostgreSQL 数据库的属性页面上，您可以管理数据库的参数。您将为数据库创建私有端点，以便所有来自 Web 应用程序的流量都通过 Azure 的网络内部路由。

在左侧菜单中，单击私有端点连接，它位于安全性下方。

现在单击顶部栏中带加号的按钮，显示私有端点。在打开的页面中

1. 为该链接提供一个名称（任何描述您要执行的操作的名称都可以，例如metabase_link）。选择数据库所在的区域，单击下一步。
2. 在配置的资源部分，确保资源类型设置为Microsoft.DBforPostgreSQL/servers，这将使您能够在下面的下拉列表中选择上一步中创建的服务器，并保留目标子资源为默认值。
3. 在配置部分，唯一需要更改的值是子网，您需要选择您在本指南第一步中创建的私有子网，并保持其他所有内容不变。

现在转到最后一步并单击创建。端点创建后，您需要执行两件事才能继续：

1. 在您刚刚创建的数据库服务器页面中，转到数据库的连接安全性项并拒绝所有公共网络访问。
2. 在您在上一步中创建的 VNET 页面中，转到连接设备设置，您应该会看到一个设备连接到网络。记下 IP 地址，因为您将在步骤 5 中需要它（这是网络分配给数据库服务器的 IP 地址）。

步骤 5：创建 Web 应用程序（部署 Metabase）

最后，所有魔法汇集在一起的步骤：转到您的资源组并添加一个新资源，或在市场中（蓝色地球图标）搜索 Web App。

现在在页面上设置以下值（资源组应与第一步相同）

• 名称：名称必须是唯一的，因为子域在所有 Azure 部署中共享。
• 发布：Docker 容器。
• 操作系统：Linux。
• 区域：使用与上一步相同的区域。
• 应用服务计划：如果您没有服务计划，Azure 将自动创建一个新计划。
• SKU 和大小：设置生产级别计划，至少包含 200 个总 ACU 和 3.5GB 内存，然后单击应用。

现在进入下一步，您将选择

• 选项：单个容器。
• 图像源：DockerHub。
• 访问类型：公共。
• 图像和标签：metabase/metabase:latest（或选择您偏好的任何其他 Docker 镜像标签，例如我们的企业版）。要查找最新版本，请查看我们的 社区版 Docker Hub 存储库 和 企业版 Docker Hub 存储库。
• 启动命令：将此字段留空。

单击下一步，直到您到达最后一节，然后单击创建，并等待您的应用程序初始化。

现在转到应用程序配置页面，单击页面左侧的设置 -> 网络。在下一页，单击VNET 集成下方的单击此处配置。

现在单击添加 VNET旁边的巨大加号，然后选择您创建的 VNET 和公共子网。单击确定。

返回到应用程序配置页面，单击页面左侧的设置 -> 配置。您应该会看到一些已配置的应用程序设置。

您需要添加用于将 Metabase 连接到其 PostgreSQL 应用程序数据库的环境变量。确保使用完整的 MB_DB_CONNECTION_URI。

此外，请注意 Azure PostgreSQL 中的用户名是 user@name_of_your_database_engine，因此在这种情况下，整个连接 URI 将如下所示：

postgresql://databasePrivateIPAddress:port/postgres?user=user@name_of_your_database_engine&password=configuredpassword&ssl=true&sslmode=required

例如，如果您的值是

1. 数据库私有 IP 地址: 10.0.2.4
2. 数据库端口：5432（Postgres 的情况，MySQL/MariaDB 默认端口是 3306）
3. 数据库服务器名称：metabase-app-database
4. 数据库用户名：metabase
5. 密码：Password1!

那么您的连接字符串将是

postgresql://10.0.2.4:5432/postgres?user=metabase%40metabase-app-database&password=Password1!&ssl=true&sslmode=require

注意：“@”字符已替换为“%40”，因为“@”在 > 43 版本中将不再起作用。

单击保存，实例将重新启动。

完成后，您应该能够通过 Web 应用程序的“概述”选项卡（在 URL 部分下方）中显示的 URL 访问您的 Metabase。

其他配置

如何启用健康检查

在 Metabase 中启用健康检查是一个好习惯。转到您的Web 应用程序 -> 监视 -> 健康检查 -> 启用健康检查，并在路径中包含/api/health。

如何升级

转到您创建的 Metabase Web 应用程序，然后单击部署 -> 部署中心。

在注册表设置下的完整镜像名称和标签文本字段中，将容器版本更改为新版本，然后单击保存。可用的 Metabase Docker 镜像版本可以在 Docker Hub 上找到。

重要提示：在升级之前，尤其是在主要版本之间升级时，务必备份 Metabase 应用程序数据库。Metabase 也不正式支持降级版本。

如何查看日志

访问 Azure 中的 Web 应用程序，导航到监视 -> 日志流。

您也应该可以在 Metabase 内部通过“设置”->“管理员”->“工具”->“日志”查看日志。

性能调优

• 禁用 FTP 状态
• 将 HTTP 版本更改为 2.0
• 启用 WebSockets
• ARR 亲和性已启用

自定义域名

在 Azure Web 应用程序中，访问设置 -> 自定义域名以使用带有您自己的证书的自定义域名。

纵向扩展与横向扩展

Azure 提供了一种通过纵向扩展来增加服务器容量的简便方法。只需选择具有更多 RAM 和 CPU 数量的定价层并重新启动实例即可。这种方法比横向扩展更容易，您应该首先选择此选项，然后再进行横向扩展。

对于高可用性的 Metabase 部署，您可以告诉您的 Web 应用进行横向扩展（更多服务器并行服务应用程序）。只需转到横向扩展并使用滑块请求更多实例，或使用自定义自动扩展策略（例如在工作时间使用更多服务器，在非工作时间使用更少服务器）。

CORS

如果您要嵌入 Metabase，可能需要在 Web 应用程序的设置 -> CORS中启用 CORS。您需要填写带有嵌入式 Metabase 的应用程序的源域，以便 Azure 知道允许来自这些域的跨域请求。

数据库名称

Azure 不允许用户在创建服务时创建数据库，这就是我们使用 postgres 作为安装 Metabase 的数据库的原因。尽管这不应该成为问题，但最佳实践是在名为 metabase 的独立数据库中安装数据库。如果您不急于尝试该产品，您应该在创建数据库后立即创建一个名为 metabase 的数据库，然后在部署 Docker 容器时使用相应的连接字符串。在上面的示例中，连接字符串将是

postgresql://10.0.2.4:5432/metabase?user=metabase@metabase-app-database&password=Password1!&ssl=true&sslmode=require

如果连接出现问题，请参阅 postgres 配置说明，因为您可能会遇到连接字符串用户名部分中的 @ 符号问题。结合使用 MB_DB_CONNECTION_URI 和单独的 MB_DB_USER 和 MB_DB_PASSWORD 字段也有效。