Skapa infrastrukturen för att köra ett MongoDB-kluster på Azure Kubernetes Service (AKS)

I den här artikeln skapar du nödvändiga infrastrukturresurser för att köra ett MongoDB-kluster på Azure Kubernetes Service (AKS).

Förutsättningar

Granska översikten för att distribuera ett MongoDB-kluster på AKS.
En Azure-prenumeration Om du inte har en skapar du ett kostnadsfritt konto.
Azure CLI version 2.61.0. Information om hur du installerar eller uppgraderar finns i Installera Azure CLI.
Helm version 3 eller senare. Information om hur du installerar finns i Installera Helm.
kubectl, som Azure Cloud Shell installerar som standard.
Docker installerat på den lokala datorn. Information om hur du installerar finns i Hämta Docker.

Ange miljövariabler

Ange de miljövariabler som krävs för användning i den här guiden:

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

Skapa en resursgrupp

Skapa en resursgrupp med kommandot az group create .

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

Exempel på utdata>

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

Skapa en identitet för åtkomst till hemligheter i Azure Key Vault

I det här steget skapar du en användartilldelad hanterad identitet som extern hemlighetsoperatör använder för att komma åt MongoDB-lösenorden som lagras i Azure Key Vault.

Skapa en användartilldelad hanterad identitet med kommandot 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)

Skapa en Azure Key Vault-instans

Skapa en Azure Key Vault-instans med kommandot az keyvault create .

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)

Exempel på utdata>

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

Skapa en Azure Container Registry-instans

Skapa en Azure Container Registry-instans för att lagra och hantera dina containeravbildningar med hjälp av az acr create kommandot .

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)

Exempel på utdata>

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

Skapa ett Azure Storage-konto

Skapa ett Azure Storage-konto för att lagra MongoDB-säkerhetskopior med hjälp av az acr create kommandot .

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

Exempel på utdata>

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

Skapa ett AKS-kluster

I följande steg skapar du ett AKS-kluster med en arbetsbelastningsidentitet och OIDC-utfärdaren (OpenID Connect) aktiverad. Arbetsbelastningsidentiteten ger tjänstkontot för externa hemligheter operatör behörighet att komma åt MongoDB-lösenorden som lagras i ditt nyckelvalv.

Skapa ett AKS-kluster med kommandot 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

Lägg till en användarnodpool i AKSc-lustern med kommandot az aks nodepool add . I den här nodpoolen körs MongoDB-poddarna.

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

Exempel på utdata>

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

Hämta url:en för OIDC-utfärdaren som ska användas för arbetsbelastningsidentitetskonfigurationen med hjälp av az aks show kommandot .

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

Tilldela AcrPull-rollen till kubelet-identiteten med kommandot 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

Ladda upp Percona-avbildningar till Azure Container Registry

I det här avsnittet laddar du ned Percona-avbildningarna från Docker Hub och laddar upp dem till Azure Container Registry. Det här steget säkerställer att avbildningen är tillgänglig i ditt privata register och kan användas i AKS-klustret. Vi rekommenderar inte att använda den publika avbildningen i en produktionsmiljö.

Importera Percona-avbildningarna från Docker Hub och ladda upp dem till Azure Container Registry med hjälp av följande az acr import kommandon:

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

Distribuera infrastrukturen med Terraform

För att distribuera infrastrukturen med Terraform använder vi Azure Verified Module för AKS. Lagringsplatsen terraform-azurerm-avm-res-containerservice-managedcluster innehåller ett fullständigt exempel med infrastrukturen som krävs för att köra ett MongoDB-kluster på Azure Kubernetes Service (AKS).

Anmärkning

Om du planerar att köra detta i produktion rekommenderar vi att du tittar på modulen AKS-produktionsmönster för Azure-verifierade moduler. Detta kombineras med rekommendationer för bästa praxis.

Klona git-lagringsplatsen med terraform-modulen:

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

Skapa en mongodb.tfvars fil för att definiera variabler med hjälp av följande kommando:

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

Kör följande Terraform-kommandon för att distribuera infrastrukturen:

terraform init
terraform fmt
terraform apply -var-file="mongodb.tfvars"

Kör följande kommando för att exportera Terraform-utdatavärdena som miljövariabler i terminalen för att använda dem i nästa steg:

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)

Anmärkning

I AKS är keepalive-tiden (varaktigheten för inaktivitet varefter den första keepalive-avsökningen skickas) standardvaraktighet 7 200 sekunder eller 2 timmar. För MongoDB får du vanligtvis bättre resultat med ett kortare keepalive-värde i storleksordningen 120 sekunder eller 2 minuter.

Ansluta till AKS-klustret

Konfigurera kubectl för att ansluta till ditt AKS-kluster med hjälp av az aks get-credentials kommandot .

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

Gå vidare

Konfigurera och distribuera MongoDB-klustret i AKS

Feedback

Var den här sidan till hjälp?

Last updated on 2025-09-15

Dela via

Skapa infrastrukturen för att köra ett MongoDB-kluster på Azure Kubernetes Service (AKS)

Förutsättningar

Ange miljövariabler

Skapa en resursgrupp

Skapa en identitet för åtkomst till hemligheter i Azure Key Vault

Skapa en Azure Key Vault-instans

Skapa en Azure Container Registry-instans

Skapa ett Azure Storage-konto

Skapa ett AKS-kluster

Ladda upp Percona-avbildningar till Azure Container Registry

Distribuera infrastrukturen med Terraform

Ansluta till AKS-klustret

Gå vidare

Feedback

Ytterligare resurser