Kurz: Použití služby PostgreSQL pro vývoj

  • Článek

Azure Container Apps umožňuje připojit se ke službám na úrovni vývoje a produkce a poskytovat tak vašim aplikacím širokou škálu funkcí.

V tomto kurzu se naučíte používat službu PostgreSQL pro vývoj s využitím aplikací kontejneru.

V tomto kurzu najdete příkazy Azure CLI a fragmenty šablon Bicep. Pokud používáte Bicep, můžete přidat všechny fragmenty do jednoho souboru Bicep a nasadit šablonu všechny najednou.

  • Vytvoření prostředí Container Apps pro nasazení aplikací služby a kontejneru
  • Vytvoření služby PostgreSQL
  • Vytvoření a použití aplikace příkazového řádku k používání služby PostgreSQL pro vývoj
  • Vytvoření aplikace pgweb
  • Zápis dat do databáze PostgreSQL

Požadavky

Poznámka

Pokud chcete nasadit jeden příkaz, přejděte k poslednímu azdkroku šablony.

Nastavení

  1. Definujte proměnné pro společné hodnoty.

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

  2. Přihlásí se k Azure.

    az login

  3. Upgradujte rozhraní příkazového řádku na nejnovější verzi.

    az upgrade

  4. Upgradujte Bicep na nejnovější verzi.

    az bicep upgrade

  5. Přidejte rozšíření containerapp .

    az extension add --name containerapp --upgrade

  6. Registrace požadovaných oborů názvů

    az provider register --namespace Microsoft.App

    az provider register --namespace Microsoft.OperationalInsights

Vytvoření prostředí Container Apps

  1. Vytvořte skupinu prostředků.

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

  2. Vytvořte prostředí Container Apps.

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

Vytvoření služby PostgreSQL

  1. Vytvořte službu PostgreSQL.

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

  2. Zobrazení výstupu protokolu z instance Postgres

    Pomocí příkazu logs zobrazte zprávy protokolu.

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

    Snímek obrazovky s protokoly služby PostgreSQL aplikace kontejneru

Vytvoření aplikace pro testování služby

Při vytváření aplikace začnete vytvořením ladicí aplikace, která použije rozhraní příkazového psql řádku pro připojení k instanci PostgreSQL.

  1. Vytvořte psql aplikaci, která vytvoří vazbu na službu PostgreSQL.

    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. Spuštěním příkazu rozhraní příkazového řádku exec se připojte k testovací aplikaci.

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

    Při použití --bind nebo serviceBinds v testovací aplikaci se informace o připojení vloží do prostředí aplikace. Po připojení k testovacímu kontejneru můžete hodnoty zkontrolovat pomocí env příkazu .

    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. Připojíme se ke službě.psql

    psql $POSTGRES_URL

    Snímek obrazovky aplikace kontejneru využívající pgsql pro připojení ke službě PostgreSQL

  4. Vytvořte tabulku s názvem accounts a vložte data.

    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;

    Snímek obrazovky aplikace kontejneru s využitím nástroje pgsql, který se připojuje k PostgreSQL, vytvoří tabulku a načte nějaká data.

Použití vývojové služby s existující aplikací

Pokud už máte aplikaci, která používá PostgreSQL, můžete změnit způsob načítání informací o připojení.

Nejprve vytvořte následující proměnné prostředí.

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

Pomocí rozhraní příkazového řádku (nebo Bicep) můžete aplikaci aktualizovat tak, aby používala --bind $PG_SVC vývojovou službu.

Vazba na službu pro vývoj

Nasaďte pgweb pro zobrazení a správu instance PostgreSQL.

Viz Bicep nebo azd příklad.

Snímek obrazovky s aplikací pgweb Container App, která se připojuje ke službě PostgreSQL

Nasazení všech prostředků

Pokud chcete nasadit všechny prostředky najednou, použijte následující příklady.

Bicep

Následující šablona Bicep obsahuje všechny prostředky v tomto kurzu.

Můžete vytvořit postgres-dev.bicep soubor s tímto obsahem.

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

K nasazení šablony použijte 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 Developer CLI

Konečná šablona je k dispozici na GitHubu.

Použijte azd up k nasazení šablony.

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

Vyčištění prostředků

Jakmile budete hotovi, spuštěním následujícího příkazu odstraňte skupinu prostředků, která obsahuje vaše prostředky Container Apps.

Upozornění

Následující příkaz odstraní zadanou skupinu prostředků a všechny prostředky v ní obsažené. Pokud v zadané skupině prostředků existují prostředky mimo rozsah tohoto kurzu, odstraní se také.

az group delete \
    --resource-group $RESOURCE_GROUP