Azure Kubernetes Service'te (AKS) MongoDB kümesi çalıştırmak için altyapı oluşturma

Bu makalede, Azure Kubernetes Service'te (AKS) mongoDB kümesi çalıştırmak için gerekli altyapı kaynaklarını oluşturacaksınız.

Prerequisites

AKS'de MongoDB kümesi dağıtmaya yönelik genel bakışı gözden geçirin.
Bir Azure aboneliği. Hesabınız yoksa ücretsiz bir hesap oluşturun.
Azure CLI sürüm 2.61.0. Yüklemek veya yükseltmek için Install the Azure CLI bölümüne bakın.
Helm sürüm 3 veya üzeri. Yüklemek için bkz Helm'i Yükleme.
kubectl, Azure Cloud Shell'in varsayılan olarak yüklediği.
Docker yerel makinenize yüklendi. Yüklemek için Docker'ı Alma sayfasına bakın.

Ortam değişkenlerini belirleme

Bu kılavuz boyunca kullanmak için gerekli ortam değişkenlerini ayarlayın:

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

Bir kaynak grubu oluşturun

az group create komutunu kullanarak bir kaynak grubu oluşturun.

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

Örnek çıkış:

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

Azure Key Vault'ta gizli bilgileri erişmek için kimlik oluşturma

Bu adımda, Dış Gizli Diziler operatörünün Azure Key Vault'ta depolanan MongoDB parolalarına erişmek için kullandığı kullanıcı tarafından atanan yönetilen kimliği oluşturursunuz.

komutunu kullanarak az identity create kullanıcı tarafından atanan bir yönetilen kimlik oluşturun.

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)

Azure Key Vault örneği oluşturun

komutunu kullanarak az keyvault create bir Azure Key Vault örneği oluşturun.

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)

Örnek çıkış:

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

Azure Container Registry örneği oluşturacaksınız

komutunu kullanarak az acr create kapsayıcı görüntülerinizi depolamak ve yönetmek için bir Azure Container Registry örneği oluşturun.

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)

Örnek çıkış:

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

Azure Depolama hesabı oluşturma

komutunu kullanarak az acr create MongoDB yedeklemelerini depolamak için bir Azure depolama hesabı oluşturun.

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

Örnek çıkış:

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

AKS kümesi oluşturma

Aşağıdaki adımları izleyerek iş yükü tanımı ve OpenID Connect (OIDC) sağlayıcısı etkin bir AKS kümesi oluşturursunuz. İş yükü kimliği, harici sırlar operatörü hizmet hesabının anahtar kasanızda saklanan MongoDB parolalarına erişmesine izin verir.

az aks create komutunu kullanarak bir AKS kümesi oluşturun.

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

az aks nodepool add komutunu kullanarak AKSc kümesine bir kullanıcı düğüm havuzu ekleyin. Bu düğüm havuzu MongoDB podlarının çalıştığı yerdir.

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

Örnek çıkış:

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

İş yükü kimlik yapılandırması için kullanılacak OIDC veren URL'sini elde etmek üzere az aks show komutunu kullanın.

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

AcrPull rolünü kubelet kimliğine atamak için az role assignment create komutunu kullanın.

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

Percona görüntülerini Azure Container Registry'ye yükleme

Bu bölümde, Docker Hub'dan Percona görüntülerini indirip Azure Container Registry'ye yüklersiniz. Bu adım, görüntünün özel kayıt defterinizde kullanılabilir olmasını ve AKS kümenizde kullanılabilmesini sağlar. Genel görüntüyü üretim ortamında kullanmanızı önermiyoruz.

Aşağıdaki komutları kullanarak Docker Hub'dan Percona görüntülerini içeri aktarın ve Azure Container Registry'ye az acr import yükleyin:

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

Terraform ile altyapıyı dağıtma

Terraform kullanarak altyapıyı dağıtmak için AKS için Azure Doğrulanmış Modülü'ni kullanacağız. terraform-azurerm-avm-res-containerservice-managedcluster deposu, Azure Kubernetes Service'te (AKS) MongoDB kümesi çalıştırmak için gereken altyapıya tam bir örnek içerir.

Uyarı

Bunu üretimde çalıştırmayı planlıyorsanız Azure Doğrulanmış Modülleri için AKS üretim deseni modülüne bakmanızı öneririz. Bu, en iyi uygulama önerileriyle birlikte gelir.

Terraform modülüyle git deposunu kopyalayın:

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

Aşağıdaki komutu kullanarak değişkenleri tanımlamak için bir mongodb.tfvars dosya oluşturun:

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

Altyapıyı dağıtmak için aşağıdaki Terraform komutlarını çalıştırın:
```
terraform init
terraform fmt
terraform apply -var-file="mongodb.tfvars"
```

Terraform çıkış değerlerini sonraki adımlarda kullanmak üzere terminalde ortam değişkenleri olarak dışarı aktarmak için aşağıdaki komutu çalıştırın:

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)

Uyarı

AKS'de, tutma süresi (ilk tutma yoklaması gönderildikten sonra etkinlik dışı kalma süresi) varsayılan süre 7.200 saniye veya 2 saattir. MongoDB için genellikle 120 saniye veya 2 dakika sırasıyla daha kısa bir tutma değeriyle daha iyi sonuçlar elde edersiniz.

AKS kümesine bağlanma

kubectl'yi, az aks get-credentials komutunu kullanarak AKS kümenize bağlanacak şekilde yapılandırın.

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

Sonraki adım

AKS'de MongoDB kümesini yapılandırma ve dağıtma

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Son güncelleştirme: 2025-09-15

Azure Kubernetes Service'te (AKS) MongoDB kümesi çalıştırmak için altyapı oluşturma

Prerequisites

Ortam değişkenlerini belirleme

Bir kaynak grubu oluşturun

Azure Key Vault'ta gizli bilgileri erişmek için kimlik oluşturma

Azure Key Vault örneği oluşturun

Azure Container Registry örneği oluşturacaksınız

Azure Depolama hesabı oluşturma

AKS kümesi oluşturma

Percona görüntülerini Azure Container Registry'ye yükleme

Terraform ile altyapıyı dağıtma

AKS kümesine bağlanma

Sonraki adım

Geri Bildirim

Ek kaynaklar