Share via

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

教程：使用 PostgreSQL 服务进行开发

  • 项目

Azure 容器应用允许连接到开发和生产级服务，为应用程序提供各种功能。

本教程介绍如何将开发 PostgreSQL 服务与容器应用配合使用。

本教程重点介绍了 Azure CLI 命令和 Bicep 模板片段。 如果使用 Bicep，可以将所有片段添加到单个 Bicep 文件，并一次性部署所有模板。

  • 创建容器应用环境以部署服务和容器应用
  • 创建 PostgreSQL 服务
  • 创建并使用命令行应用以使用开发 PostgreSQL 服务
  • 创建 pgweb 应用
  • 将数据写入 PostgreSQL 数据库

先决条件

注意

对于单命令部署，请跳到最后一个azd模板步骤。

设置

  1. 为通用值定义变量。

    RESOURCE_GROUP="postgres-dev"
LOCATION="northcentralus"
ENVIRONMENT="aca-env"
PG_SVC="postgres01"
PSQL_CLI_APP="psql-cloud-cli-app"

  2. 登录 Azure。

    az login

  3. 将 CLI 升级到最新版本。

    az upgrade

  4. 将 Bicep 升级到最新版本。

    az bicep upgrade

  5. 添加 containerapp 扩展。

    az extension add --name containerapp --upgrade

  6. 注册所需的命名空间。

    az provider register --namespace Microsoft.App

    az provider register --namespace Microsoft.OperationalInsights

创建容器应用环境

  1. 创建资源组。

    az group create \
    --name "$RESOURCE_GROUP" \
    --location "$LOCATION"

  2. 创建容器应用环境。

    az containerapp env create \
  --name "$ENVIRONMENT" \
  --resource-group "$RESOURCE_GROUP" \
  --location "$LOCATION"

创建 PostgreSQL 服务

  1. 创建 PostgreSQL 服务。

    az containerapp add-on postgres create \
    --name "$PG_SVC" \
    --resource-group "$RESOURCE_GROUP" \
    --environment "$ENVIRONMENT"

  2. 查看 Postgres 实例的日志输出

    使用 logs 命令查看日志消息。

    az containerapp logs show \
    --name $PG_SVC \
    --resource-group $RESOURCE_GROUP \
    --follow --tail 30

    容器应用 PostgreSQL 服务日志的屏幕截图。

创建应用以测试服务

创建应用时，先创建一个调试应用，以使用 psql CLI 连接到 PostgreSQL 实例。

  1. 创建绑定到 PostgreSQL 服务的 psql 应用。

    az containerapp create \
    --name "$PSQL_CLI_APP" \
    --image mcr.microsoft.com/k8se/services/postgres:14 \
    --bind "$PG_SVC" \
    --environment "$ENVIRONMENT" \
    --resource-group "$RESOURCE_GROUP" \
    --min-replicas 1 \
    --max-replicas 1 \
    --command "/bin/sleep" "infinity"

  2. 运行 CLI exec 命令以连接到测试应用。

    az containerapp exec \
    --name $PSQL_CLI_APP \
    --resource-group $RESOURCE_GROUP \
    --command /bin/bash

    对测试应用使用 --bind 或 serviceBinds 时，连接信息会注入到应用程序环境中。 连接到测试容器后，可以使用 env 命令检查值。

    env | grep "^POSTGRES_"

POSTGRES_HOST=postgres01
POSTGRES_PASSWORD=AiSf...
POSTGRES_SSL=disable
POSTGRES_URL=postgres://postgres:AiSf...@postgres01:5432/postgres?sslmode=disable
POSTGRES_DATABASE=postgres
POSTGRES_PORT=5432
POSTGRES_USERNAME=postgres
POSTGRES_CONNECTION_STRING=host=postgres01 database=postgres user=postgres password=AiSf...

  3. 使用 psql 连接到服务

    psql $POSTGRES_URL

    使用 pgsql 连接到 PostgreSQL 服务的容器应用的屏幕截图。

  4. 创建名为 accounts 的表并插入数据。

    postgres=# CREATE TABLE accounts (
    user_id serial PRIMARY KEY,
    username VARCHAR ( 50 ) UNIQUE NOT NULL,
    email VARCHAR ( 255 ) UNIQUE NOT NULL,
    created_on TIMESTAMP NOT NULL,
    last_login TIMESTAMP 
);

postgres=# INSERT INTO accounts (username, email, created_on)
VALUES
('user1', 'user1@example.com', current_timestamp),
('user2', 'user2@example.com', current_timestamp),
('user3', 'user3@example.com', current_timestamp);

postgres=# SELECT * FROM accounts;

    使用 pgsql 连接到 PostgreSQL 的容器应用的屏幕截图，创建表并插入一些数据。

将开发服务与现有应用配合使用

如果已有使用 PostgreSQL 的应用，可以更改加载连接信息的方式。

首先，创建以下环境变量。

POSTGRES_HOST=postgres01
POSTGRES_PASSWORD=AiSf...
POSTGRES_SSL=disable
POSTGRES_URL=postgres://postgres:AiSf...@postgres01:5432/postgres?sslmode=disable
POSTGRES_DATABASE=postgres
POSTGRES_PORT=5432
POSTGRES_USERNAME=postgres
POSTGRES_CONNECTION_STRING=host=postgres01 database=postgres user=postgres password=AiSf...

借助 CLI（或 Bicep），可以更新应用，添加 --bind $PG_SVC 以使用开发服务。

绑定到开发服务

部署 pgweb 以查看和管理 PostgreSQL 实例。

请参阅 Bicep 或 azd 示例。

连接到 PostgreSQL 服务的 pgweb 容器应用的屏幕截图。

部署所有资源

如果要一次性部署所有资源，请使用以下示例。

Bicep

以下 Bicep 模板包含本教程中使用的所有资源。

可以创建包含此内容的 postgres-dev.bicep 文件。

targetScope = 'resourceGroup'
param location string = resourceGroup().location
param appEnvironmentName string = 'aca-env'
param pgSvcName string = 'postgres01'
param pgsqlCliAppName string = 'psql-cloud-cli-app'

resource logAnalytics 'Microsoft.OperationalInsights/workspaces@2022-10-01' = {
  name: '${appEnvironmentName}-log-analytics'
  location: location
  properties: {
    sku: {
      name: 'PerGB2018'
    }
  }
}

resource appEnvironment 'Microsoft.App/managedEnvironments@2023-04-01-preview' = {
  name: appEnvironmentName
  location: location
  properties: {
    appLogsConfiguration: {
      destination: 'log-analytics'
      logAnalyticsConfiguration: {
        customerId: logAnalytics.properties.customerId
        sharedKey: logAnalytics.listKeys().primarySharedKey
      }
    }
  }
}

resource postgres 'Microsoft.App/containerApps@2023-04-01-preview' = {
name: pgSvcName
  location: location
  properties: {
    environmentId: appEnvironment.id
    configuration: {
      service: {
          type: 'postgres'
      }
    }
  }
}

resource pgsqlCli 'Microsoft.App/containerApps@2023-04-01-preview' = {
  name: pgsqlCliAppName
  location: location
  properties: {
    environmentId: appEnvironment.id
    template: {
      serviceBinds: [
        {
          serviceId: postgres.id
        }
      ]
      containers: [
        {
          name: 'psql'
          image: 'mcr.microsoft.com/k8se/services/postgres:14'
          command: [ '/bin/sleep', 'infinity' ]
        }
      ]
      scale: {
        minReplicas: 1
        maxReplicas: 1
      }
    }
  }
}

resource pgweb 'Microsoft.App/containerApps@2023-04-01-preview' = {
  name: 'pgweb'
  location: location
  properties: {
    environmentId: appEnvironment.id
    configuration: {
      ingress: {
        external: true
        targetPort: 8081
      }
    }
    template: {
      serviceBinds: [
        {
          serviceId: postgres.id
          name: 'postgres'
        }
      ]
      containers: [
        {
          name: 'pgweb'
          image: 'docker.io/sosedoff/pgweb:latest'
          command: [
            '/bin/sh'
          ]
          args: [
            '-c'
            'PGWEB_DATABASE_URL=$POSTGRES_URL /usr/bin/pgweb --bind=0.0.0.0 --listen=8081'
          ]
        }
      ]
    }
  }
}

output pgsqlCliExec string = 'az containerapp exec -n ${pgsqlCli.name} -g ${resourceGroup().name} --revision ${pgsqlCli.properties.latestRevisionName} --command /bin/bash'

output postgresLogs string = 'az containerapp logs show -n ${postgres.name} -g ${resourceGroup().name} --follow --tail 30'

output pgwebUrl string = 'https://${pgweb.properties.configuration.ingress.fqdn}'

使用 Azure CLI 部署模板。

RESOURCE_GROUP="postgres-dev"
LOCATION="northcentralus"

az group create \
    --name "$RESOURCE_GROUP" \
    --location "$LOCATION"

az deployment group create -g $RESOURCE_GROUP \
    --query 'properties.outputs.*.value' \
    --template-file postgres-dev.bicep

Azure 开发人员 CLI

GitHub 上提供了一个最终模板。

使用 azd up 部署模板。

git clone https://github.com/Azure-Samples/aca-dev-service-postgres-azd
cd aca-dev-service-postgres-azd
azd up

清理资源

完成后，运行以下命令以删除包含容器应用资源的资源组。

注意

以下命令删除指定的资源组及其包含的所有资源。 如果指定的资源组中存在本教程范围外的资源，这些资源也会被删除。

az group delete \
    --resource-group $RESOURCE_GROUP