Vytvoření infrastruktury pro spuštění clusteru MongoDB ve službě Azure Kubernetes Service (AKS)

V tomto článku vytvoříte požadované prostředky infrastruktury pro spuštění clusteru MongoDB ve službě Azure Kubernetes Service (AKS).

Prerequisites

Projděte si přehled nasazení clusteru MongoDB v AKS.
Předplatné služby Azure. Pokud žádné nemáte, vytvořte si bezplatný účet.
Azure CLI verze 2.61.0. Pokud chcete nainstalovat nebo upgradovat, přečtěte si téma Instalace Azure CLI.
Helm verze 3 nebo novější Postup instalace najdete v tématu Instalace Helm.
kubectl, který azure Cloud Shell nainstaluje ve výchozím nastavení.
Docker nainstalovaný na místním počítači. Informace o instalaci najdete v tématu Get Docker.

Nastavení proměnných prostředí

Nastavte požadované proměnné prostředí pro použití v tomto průvodci:

random=$(echo $RANDOM | tr '[0-9]' '[a-z]')
export MY_LOCATION=australiaeast
export MY_RESOURCE_GROUP_NAME=myResourceGroup-rg-$(echo $MY_LOCATION)
export MY_ACR_REGISTRY=mydnsrandomname$(echo $random)
export MY_IDENTITY_NAME=ua-identity-123
export MY_KEYVAULT_NAME=vault-$(echo $random)-kv
export MY_CLUSTER_NAME=cluster-aks
export SERVICE_ACCOUNT_NAME=mongodb
export SERVICE_ACCOUNT_NAMESPACE=mongodb
export AKS_MONGODB_NAMESPACE=mongodb
export AKS_MONGODB_SECRETS_NAME=cluster-aks-mongodb-secrets
export AKS_MONGODB_CLUSTER_NAME=cluster-aks-mongodb
export AKS_MONGODB_SECRETS_ENCRYPTION_KEY=cluster-aks-mongodb-secrets-mongodb-encryption-key
export AKS_AZURE_SECRETS_NAME=cluster-aks-azure-secrets
export AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_NAME=mongodbsa$(echo $random)
export AKS_MONGODB_BACKUP_STORAGE_CONTAINER_NAME=backups

Vytvoření skupiny zdrojů

Vytvořte skupinu prostředků pomocí příkazu az group create.

az group create --name $MY_RESOURCE_GROUP_NAME --location $MY_LOCATION --output table

Příklad výstupu:

Location       Name
-------------  --------------------------------
australiaeast  myResourceGroup-rg-australiaeast

Vytvoření identity pro přístup k tajným kódům ve službě Azure Key Vault

V tomto kroku vytvoříte spravovanou identitu přiřazenou uživatelem, kterou operátor externích tajných kódů používá pro přístup k heslům MongoDB uloženým ve službě Azure Key Vault.

Vytvořte spravovanou identitu přiřazenou uživatelem pomocí příkazu az identity create.

az identity create --name $MY_IDENTITY_NAME --resource-group $MY_RESOURCE_GROUP_NAME --output none
export MY_IDENTITY_NAME_ID=$(az identity show --name $MY_IDENTITY_NAME -g $MY_RESOURCE_GROUP_NAME --query id -o tsv)
export MY_IDENTITY_NAME_PRINCIPAL_ID=$(az identity show --name $MY_IDENTITY_NAME -g $MY_RESOURCE_GROUP_NAME --query principalId -o tsv)
export MY_IDENTITY_NAME_CLIENT_ID=$(az identity show --name $MY_IDENTITY_NAME -g $MY_RESOURCE_GROUP_NAME --query clientId -o tsv)

Vytvoření instance služby Azure Key Vault

Pomocí příkazu vytvořte instanci az keyvault create služby Azure Key Vault.

az keyvault create --name $MY_KEYVAULT_NAME --resource-group $MY_RESOURCE_GROUP_NAME --location $MY_LOCATION --enable-rbac-authorization false --output table
export KEYVAULTID=$(az keyvault show --name $MY_KEYVAULT_NAME --query "id" --output tsv)
export KEYVAULTURL=$(az keyvault show --name $MY_KEYVAULT_NAME --query "properties.vaultUri" --output tsv)

Příklad výstupu:

Location       Name            ResourceGroup
-------------  --------------  --------------------------------
australiaeast  vault-cjcfc-kv  myResourceGroup-rg-australiaeast

Vytvořit instanci služby Azure Container Registry

Pomocí příkazu vytvořte instanci služby Azure Container Registry pro ukládání a správu imagí kontejneru az acr create .

az acr create \
--name ${MY_ACR_REGISTRY} \
--resource-group $MY_RESOURCE_GROUP_NAME \
--sku Premium \
--location $MY_LOCATION \
--admin-enabled true \
--output table
export MY_ACR_REGISTRY_ID=$(az acr show --name $MY_ACR_REGISTRY --resource-group $MY_RESOURCE_GROUP_NAME --query id -o tsv)

Příklad výstupu:

NAME                  RESOURCE GROUP                    LOCATION       SKU      LOGIN SERVER                     CREATION DATE         ADMIN ENABLED
--------------------  --------------------------------  -------------  -------  -------------------------------  --------------------  ---------------
mydnsrandomnamecjcfc  myResourceGroup-rg-australiaeast  australiaeast  Premium  mydnsrandomnamecjcfc.azurecr.io  2024-07-01T12:18:34Z  True

Vytvoření účtu úložiště Azure

Vytvořte účet úložiště Azure pro ukládání záloh MongoDB pomocí az acr create příkazu.

az storage account create --name $AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_NAME --resource-group $MY_RESOURCE_GROUP_NAME --location $MY_LOCATION --sku Standard_ZRS --output table
az storage container create --name $AKS_MONGODB_BACKUP_STORAGE_CONTAINER_NAME --account-name $AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_NAME --output table
export AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_KEY=$(az storage account keys list --account-name $AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_NAME --query "[0].value" -o tsv)
az keyvault secret set --vault-name $MY_KEYVAULT_NAME --name AZURE-STORAGE-ACCOUNT-KEY --value $AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_KEY --output none

Příklad výstupu:

AccessTier    AllowBlobPublicAccess    AllowCrossTenantReplication    CreationTime                      EnableHttpsTrafficOnly    Kind       Location       MinimumTlsVersion    Name            PrimaryLocation    ProvisioningState    ResourceGroup
StatusOfPrimary
------------  -----------------------  -----------------------------  --------------------------------  ------------------------  ---------  -------------  -------------------  --------------  -----------------  -------------------  --------------------------------  -----------------
Hot           False                    False                          2024-08-09T07:06:41.727230+00:00  True                      StorageV2  australiaeast  TLS1_0               mongodbsabdibh  australiaeast      Succeeded            myResourceGroup-rg-australiaeast  available
Created
---------
True

Vytvoření clusteru AKS

V následujících krocích vytvoříte cluster AKS s povolenou identitou pracovního zatížení a s povoleným vydavatelem OpenID Connect (OIDC). Identita úlohy dává účtu služby External Secrets Operator oprávnění k přístupu k heslům MongoDB uloženým ve vašem trezoru klíčů.

Vytvořte cluster AKS pomocí příkazu az aks create.

az aks create \
--location $MY_LOCATION \
--name $MY_CLUSTER_NAME \
--tier standard \
--resource-group $MY_RESOURCE_GROUP_NAME \
--network-plugin azure \
--node-vm-size Standard_DS4_v2 \
--node-count 1 \
--nodepool-name systempool \
--nodepool-tags "pool=system" \
--auto-upgrade-channel stable \
--node-os-upgrade-channel NodeImage \
--attach-acr ${MY_ACR_REGISTRY} \
--enable-oidc-issuer \
--enable-workload-identity \
--zones 1 2 3 \
--generate-ssh-keys \
--output none

Přidejte pool uzlů uživatele do klastru AKS pomocí az aks nodepool add příkazu. V tomto fondu uzlů běží pody MongoDB.

az aks nodepool add \
--resource-group $MY_RESOURCE_GROUP_NAME \
--cluster-name $MY_CLUSTER_NAME \
--name mongodbpool \
--node-vm-size Standard_DS4_v2 \
--node-count 3 \
--zones 1 2 3 \
--mode User \
--output table

Příklad výstupu:

Name        OsType    KubernetesVersion    VmSize           Count    MaxPods    ProvisioningState    Mode
----------  --------  -------------------  ---------------  -------  ---------  -------------------  ------
userpool    Linux     1.28                 Standard_DS4_v2  3        30         Succeeded            User

Získejte pomocí příkazu az aks show adresu URL vystavitele OIDC, která se má použít pro konfiguraci identity pracovní zátěže.

export OIDC_URL=$(az aks show --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_CLUSTER_NAME --query oidcIssuerProfile.issuerUrl -o tsv)

Pomocí příkazu AcrPull přiřaďte roli k identitě kubeletu az role assignment create.

export KUBELET_IDENTITY=$(az aks show -g $MY_RESOURCE_GROUP_NAME --name $MY_CLUSTER_NAME -o tsv --query identityProfile.kubeletidentity.objectId)
az role assignment create \
--assignee ${KUBELET_IDENTITY} \
--role "AcrPull" \
--scope ${MY_ACR_REGISTRY_ID} \
--output none

Nahrání imagí Percona do služby Azure Container Registry

V této části stáhnete image Percona z Docker Hubu a nahrajete je do služby Azure Container Registry. Tento krok zajistí, že je image dostupná ve vašem privátním registru a dá se použít v clusteru AKS. Nedoporučujeme používat veřejnou image v produkčním prostředí.

Importujte image Percona z Docker Hubu a nahrajte je do služby Azure Container Registry pomocí následujících az acr import příkazů:

az acr import \
    --name $MY_ACR_REGISTRY \
    --source docker.io/percona/percona-server-mongodb:7.0.8-5  \
    --image percona-server-mongodb:7.0.8-5

az acr import \
    --name $MY_ACR_REGISTRY \
    --source docker.io/percona/pmm-client:2.41.2  \
    --image pmm-client:2.41.2

az acr import \
    --name $MY_ACR_REGISTRY \
    --source docker.io/percona/percona-backup-mongodb:2.4.1  \
    --image percona-backup-mongodb:2.4.1

az acr import \
    --name $MY_ACR_REGISTRY \
    --source docker.io/percona/percona-server-mongodb-operator:1.16.1  \
    --image percona-server-mongodb-operator:1.16.1

Nasazení infrastruktury pomocí Terraformu

K nasazení infrastruktury pomocí Terraformu použijeme ověřený modul Azure pro AKS. Úložiště terraform-azurerm-avm-res-containerservice-managedcluster obsahuje úplný příklad s infrastrukturou potřebnou ke spuštění clusteru MongoDB ve službě Azure Kubernetes Service (AKS).

Poznámka:

Pokud plánujete tento postup spustit v produkčním prostředí, doporučujeme prohlédnout si modul produkčního modelu AKS pro ověřené moduly Azure. To je spojeno s doporučeními osvědčených postupů.

Naklonujte úložiště Git pomocí modulu terraformu:

git clone https://github.com/Azure/terraform-azurerm-avm-res-containerservice-managedcluster.git
cd examples/stateful-workloads

Vytvořte mongodb.tfvars soubor pro definování proměnných pomocí následujícího příkazu:

cat > mongodb.tfvars <<EOL
location = "$MY_LOCATION"
resource_group_name = "$MY_RESOURCE_GROUP_NAME"
acr_registry_name = "$MY_ACR_REGISTRY"
cluster_name = "$MY_CLUSTER_NAME"
identity_name = "$MY_IDENTITY_NAME"
keyvault_name = "$MY_KEYVAULT_NAME"
aks_mongodb_backup_storage_account_name = "$AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_NAME"
aks_mongodb_backup_storage_container_name = "$AKS_MONGODB_BACKUP_STORAGE_CONTAINER_NAME"
mongodb_enabled = true
mongodb_namespace = "$AKS_MONGODB_NAMESPACE"
service_account_name = "$SERVICE_ACCOUNT_NAME"

acr_task_content = <<-EOF
version: v1.1.0
steps:
  - cmd: bash echo Waiting 10 seconds the propagation of the Container Registry Data Importer and Data Reader role
  - cmd: bash sleep 10
  - cmd: az login --identity
  - cmd: az acr import --name \$RegistryName --source docker.io/percona/percona-server-mongodb:7.0.8-5 --image percona-server-mongodb:7.0.8-5
  - cmd: az acr import --name \$RegistryName --source docker.io/percona/pmm-client:2.41.2 --image pmm-client:2.41.2
  - cmd: az acr import --name \$RegistryName --source docker.io/percona/percona-backup-mongodb:2.4.1 --image percona-backup-mongodb:2.4.1
  - cmd: az acr import --name \$RegistryName --source docker.io/percona/percona-server-mongodb-operator:1.16.1 --image percona-server-mongodb-operator:1.16.1
EOF

node_pools = {
  mongodbserver = {
    name       = "mongodbpool"
    vm_size    = "Standard_D2ds_v4"
    node_count = 3
    zones      = [1, 2, 3]
    os_type    = "Linux"
  }
}
EOL

Spuštěním následujících příkazů Terraformu nasaďte infrastrukturu:
```
terraform init
terraform fmt
terraform apply -var-file="mongodb.tfvars"
```

Spuštěním následujícího příkazu vyexportujte výstupní hodnoty Terraformu jako proměnné prostředí v terminálu, abyste je mohli použít v dalších krocích:

export MY_ACR_REGISTRY_ID=$(terraform output -raw acr_registry_id)
export MY_ACR_REGISTRY=$(terraform output -raw acr_registry_name)
export MY_CLUSTER_NAME=$(terraform output -raw aks_cluster_name)
export KUBELET_IDENTITY=$(terraform output -raw aks_kubelet_identity_id)
export OIDC_URL=$(terraform output -raw aks_oidc_issuer_url)
export identity_name=$(terraform output -raw identity_name)
export MY_IDENTITY_NAME_ID=$(terraform output -raw identity_name_id)
export MY_IDENTITY_NAME_PRINCIPAL_ID=$(terraform output -raw identity_name_principal_id)
export MY_IDENTITY_NAME_CLIENT_ID=$(terraform output -raw identity_name_client_id)
export KEYVAULTID=$(terraform output -raw key_vault_id)
export KEYVAULTURL=$(terraform output -raw key_vault_uri)
export AKS_MONGODB_BACKUP_STORAGE_ACCOUNT_KEY=$(terraform output -raw storage_account_key)
export STORAGE_ACCOUNT_NAME=$(terraform output -raw storage_account_name)
export TENANT_ID=$(terraform output -raw identity_name_tenant_id)

Poznámka:

V AKS je výchozí doba udržování (doba nečinnosti, po které se odešle první keepalive sonda) 7 200 sekund nebo 2 hodiny. Pro MongoDB obecně dosáhnete lepších výsledků s kratším intervalem keepalive, přibližně 120 sekund nebo 2 minuty.

Připojení ke clusteru AKS

Nakonfigurujte kubectl pro připojení ke clusteru AKS pomocí příkazu az aks get-credentials.

az aks get-credentials --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_CLUSTER_NAME --overwrite-existing --output table

Další krok

Konfigurace a nasazení clusteru MongoDB v AKS

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2025-09-22

Vytvoření infrastruktury pro spuštění clusteru MongoDB ve službě Azure Kubernetes Service (AKS)

Prerequisites

Nastavení proměnných prostředí

Vytvoření skupiny zdrojů

Vytvoření identity pro přístup k tajným kódům ve službě Azure Key Vault

Vytvoření instance služby Azure Key Vault

Vytvořit instanci služby Azure Container Registry

Vytvoření účtu úložiště Azure

Vytvoření clusteru AKS

Nahrání imagí Percona do služby Azure Container Registry

Nasazení infrastruktury pomocí Terraformu

Připojení ke clusteru AKS

Další krok

Váš názor

Další materiály