Azure Kubernetes Service kümeniz için yükseltmeleri zamanlamak ve denetlemek için planlı bakımı kullanma

2025-04-07

Bu makalede, Azure Kubernetes Service'te (AKS) küme ve düğüm görüntüsü yükseltmelerini zamanlamak ve denetlemek için planlı bakımın nasıl kullanılacağı gösterilmektedir.

AKS kümenizde düzenli bakım otomatik olarak gerçekleştirilir. İki tür bakım işlemi vardır:

AKS tarafından başlatılan bakım , AKS'nin kümenizi en son özellikler ve düzeltmelerle güncel tutmak için gerçekleştirdiği haftalık sürümleri içerir.
Kullanıcı tarafından başlatılan bakım, küme otomatik yükseltmelerini ve düğüm işletim sistemi (OS) otomatik güvenlik güncelleştirmelerini içerir.

AKS'de planlı bakım özelliğini kullandığınızda, iş yükü etkisini en aza indirmek için her iki bakım türünü de istediğiniz bir tempoda çalıştırabilirsiniz.

Not

Otomatik yükseltmelerin zamanlamasını zamanlamak için planlı bakımı kullanabilirsiniz, ancak planlı bakımı etkinleştirmek veya devre dışı bırakmak otomatik yükseltmeleri etkinleştirmez veya devre dışı bırakmaz.

Başlamadan önce

Bu makalede, mevcut bir AKS kümeniz olduğu varsayılır. AKS kümeniz yoksa Bir AKS kümesi oluşturun bölümüne bakın.
Azure CLI kullanıyorsanız komutunu kullanarak en son sürüme yükseltin az upgrade .

Dikkat edilmesi gereken noktalar

Planlı bakımı kullandığınızda aşağıdaki noktalar geçerlidir:

AKS, acil veya kritik plansız, reaktif bakım işlemleri için planlı bakım pencerelerini kesme hakkını saklıdır. Bu bakım işlemleri, yapılandırmanızda tanımlanan notAllowedTime veya notAllowedDates dönemleri sırasında çalıştırılabilir.
Bakım işlemleri yalnızca en iyi çaba olarak kabul edilir ve belirtilen bir pencerede gerçekleşmesi garanti edilmez.

Planlı bakım için yapılandırma türlerini zamanlama

Planlı bakım için üç zamanlama yapılandırma türü mevcuttur:

default AKS sürümlerini denetlemeye yönelik temel bir yapılandırmadır. Azure güvenli dağıtım uygulamaları nedeniyle yayınların ilk gönderim zamanından itibaren tüm bölgelere dağıtılmasının iki hafta kadar sürmesi gerekir.

Bu güncelleştirmeleri sizin için en az kesintiye neden olacak şekilde zamanlamayı seçin default . Haftalık yayın izleyicisi ile bölgeye göre devam eden bir AKS sürümünün durumunu izleyebilirsiniz.
aksManagedAutoUpgradeSchedule , belirlenen otomatik yükseltme kanalınız tarafından zamanlanan küme yükseltmelerini ne zaman gerçekleştirebileceğinizi denetler. default yapılandırmasına kıyasla, bu yapılandırma ile daha detaylı olarak kontrol edilebilen ritim ve tekrarlama ayarlarını yapılandırabilirsiniz. Küme otomatik yükseltmesi hakkında daha fazla bilgi için bkz . Azure Kubernetes Service kümesini otomatik olarak yükseltme.
aksManagedNodeOSUpgradeSchedule , düğüm işletim sistemi otomatik yükseltme kanalınız tarafından planlanan düğüm işletim sistemi güvenlik yamalarını ne zaman uygulayacağını kontrol eder. default yapılandırmasına kıyasla, bu yapılandırma ile daha detaylı olarak kontrol edilebilen ritim ve tekrarlama ayarlarını yapılandırabilirsiniz. Düğüm işletim sistemi otomatik yükseltme kanalları hakkında daha fazla bilgi için bkz AKS kümesi düğüm görüntülerini otomatik olarak düzeltme ve güncelleme.

Tüm küme yükseltme senaryoları için aksManagedAutoUpgradeSchedule kullanılmasını öneririz ve tüm düğüm işletim sistemi güvenlik düzeltme eki uygulama senaryoları için aksManagedNodeOSUpgradeSchedule kullanılmasını öneririz.

Bu default seçenek yalnızca AKS haftalık sürümlerine yöneliktir. default komutunu kullanarak aksManagedAutoUpgradeSchedule yapılandırmasını aksManagedNodeOSUpgradeSchedule veya az aks maintenanceconfiguration update yapılandırmasına geçirebilirsiniz.

Bakım penceresi oluşturma

Not

Otomatik yükseltmeyi kullanırken doğru işlevselliği sağlamak için dört saat veya daha uzun bir süreye sahip bir bakım penceresi kullanın.

Planlı bakım pencereleri Eşgüdümlü Evrensel Saat (UTC) olarak belirtilir.

Bakım default penceresi aşağıdaki eski özelliklere sahiptir (artık önerilmez):

İsim	Açıklama	Varsayılan değer
`timeInWeek`	Bir `default` yapılandırmada, bu özellik, bir bakım penceresini tanımlayan `day` ve `hourSlots` değerlerini içerir.	Uygulanamaz
`timeInWeek.day`	`default` yapılandırmasında bakım çalışmasının yapılacağı hafta günü.	Uygulanamaz
`timeInWeek.hourSlots`	Yapılandırmada belirli bir günde `default` bakım yapmak için saat uzunluğundaki zaman aralıklarının listesi.	Uygulanamaz
`notAllowedTime`	`start` ve `end` alt özellikleri tarafından belirlenen, bakımın çalıştırılamayacağı tarih aralığı. Bu özellik yalnızca bir yapılandırma dosyası kullanarak bakım penceresi oluştururken geçerlidir.	Uygulanamaz

Not

2023-05-01 API sürümünden itibaren lütfen yapılandırma için default aşağıdaki özellikleri kullanın.

2023-05-01 API sürümünden sonraki bir aksManagedAutoUpgradeSchedule veya aksManagedNodeOSUpgradeSchedule bakım penceresi ve default yapılandırması aşağıdaki özelliklere sahiptir:

İsim	Açıklama	Varsayılan değer
`utcOffset`	Küme bakımı için belirlenen saat dilimi.	`+00:00`
`startDate`	Bakım penceresinin geçerlilik almaya başladığı tarih.	Oluşturma zamanındaki geçerli tarih
`startTime`	tarafından `utcOffset`belirlenen saat dilimine göre bakımın başlama zamanı.	Uygulanamaz
`schedule`	Yükseltme sıklığı. Üç tür kullanılabilir: `Weekly`, `AbsoluteMonthly`ve `RelativeMonthly`.	Uygulanamaz
`intervalDays`	Bakım çalışmaları için gün cinsinden aralık. Yalnızca `aksManagedNodeOSUpgradeSchedule` için geçerlidir.	Uygulanamaz
`intervalWeeks`	Bakım işlemleri için haftalık aralık.	Uygulanamaz
`intervalMonths`	Bakım işlemleri için ay olarak aralık.	Uygulanamaz
`dayOfWeek`	Bakımın başlaması için belirlenen haftanın günü.	Uygulanamaz
`durationHours`	Bakımın yürütülmesi için pencere süresi.	Uygulanamaz
`notAllowedDates`	`start` ve `end` alt özellikleri tarafından belirlenen, bakımın çalıştırılamayacağı tarih aralığı. Bu yalnızca bir yapılandırma dosyası kullanarak bakım penceresi oluştururken geçerlidir.	Uygulanamaz

Zamanlama türleri

Dört zamanlama türü desteklenir:Daily , WeeklyAbsoluteMonthlyve RelativeMonthly.
Aşağıdaki tabloda, her bakım-yapılandırma seçeneği için hangi türlerin kullanılabildiği gösterilmektedir.

Not
Haziran 2025'ten itibaren Daily program türü, aksManagedClusterAutoUpgradeSchedule için de desteklenecektir.

Zamanlama türü	`default`	`aksManagedClusterAutoUpgradeSchedule`	`aksManagedNodeOSUpgradeSchedule`
Günlük	❌	✅ (Haziran 2025'te)	✅
Haftalık	✅	✅	✅
AbsoluteMonthly	✅	✅	✅
RelativeMonthly	✅	✅	✅

Her zamanlama türü için gösterilen tüm alanlar gereklidir.

Zamanlama Daily "her üç günde bir" gibi görünebilir:

"schedule": {
    "daily": {
        "intervalDays": 3
    }
}

Bir Weekly program "her iki haftada bir Cuma günü" şeklinde olabilir.

"schedule": {
    "weekly": {
        "intervalWeeks": 2,
        "dayOfWeek": "Friday"
    }
}

Bir AbsoluteMonthly takvimi "her üç ayda bir, ayın ilk gününde" gibi görünebilir.

"schedule": {
    "absoluteMonthly": {
        "intervalMonths": 3,
        "dayOfMonth": 1
    }
}

Bir RelativeMonthly zamanlama "her iki ayda bir son Pazartesi günü" gibi görünebilir.

"schedule": {
    "relativeMonthly": {
        "intervalMonths": 2,
        "dayOfWeek": "Monday",
        "weekIndex": "Last"
    }
}

için weekIndex geçerli değerler : First, Second, Third, Fourthve Last.

Bakım penceresi yapılandırması ekleyin

komutunu kullanarak az aks maintenanceconfiguration add AKS kümesine bakım penceresi yapılandırması ekleyin.

İlk örnek, bakımı her Pazartesi 01:00 ile 02:00 arasında çalışacak şekilde zamanlayan yeni default bir yapılandırma ekler. İkinci örnek, aksManagedAutoUpgradeSchedule saat diliminde her ayın üçüncü Cuma günü 12:00 AM ile 8:00 AM arasında çalışacak şekilde bakım zamanlayan yeni bir UTC+5:30 yapılandırma ekler.

# Add a new default configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 1

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --schedule-type Weekly --day-of-week Friday --interval-weeks 3 --duration 8 --utc-offset +05:30 --start-time 00:00

Not

Yapılandırma türü default olan bir ortamda, gün içinde herhangi bir saatte bakım yapılmasına izin vermek için --start-time parametresini atlayabilirsiniz.

Parametreleri kullanmak yerine bakım yapılandırması oluşturmak için bir JSON dosyası kullanabilirsiniz. Bu yöntemi kullandığınızda, notAllowedTimes yapılandırmalar ve default yapılandırmalar için notAllowedDates ve aksManagedAutoUpgradeSchedule belirterek belli tarihler arasında bakım yapılmasını engelleyebilirsiniz.

Bakım penceresi ayarlarıyla bir JSON dosyası oluşturun.

Aşağıdaki örnek, her Salı ve Çarşamba saat diliminde default.json bakımı 01:00 ile 03:00 arasında çalışacak şekilde zamanlayan bir UTC dosya oluşturur. 2021-05-26T03:00:00Z ile 2021-05-30T12:00:00Z arasında, bakım penceresiyle çakışsa bile bakımın izin verilmediği bir istisna da vardır.

{
  "timeInWeek": [
    {
      "day": "Tuesday",
      "hour_slots": [
        1,
        2
      ]
    },
    {
      "day": "Wednesday",
      "hour_slots": [
        1,
        6
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}

Aşağıdaki örnek, autoUpgradeWindow.json saat diliminde ayın ilk gününde, 09:00 ile 13:00 arasında, üç ayda bir çalışacak şekilde bakım zamanlayan bir UTC-08 dosyası oluşturur. 2023-12-23 ile 2024-01-05 arasında, bakım penceresiyle çakışsa bile bakımın izin verilmediği bir istisna da vardır.

{
  "properties": {
    "maintenanceWindow": {
        "schedule": {
            "absoluteMonthly": {
                "intervalMonths": 3,
                "dayOfMonth": 1
            }
        },
        "durationHours": 4,
        "utcOffset": "-08:00",
        "startTime": "09:00",
        "notAllowedDates": [
            {
                "start": "2023-12-23",
                "end": "2024-01-05"
            }
        ]
    }
  }
}

az aks maintenanceconfiguration add komutunu --config-file parametresiyle kullanarak bakım penceresi yapılandırmasını ekleyin.

İlk örnek, default dosyasını kullanarak yeni bir default.json yapılandırma ekler. İkinci örnek, aksManagedAutoUpgradeSchedule dosyasını kullanarak yeni bir autoUpgradeWindow.json yapılandırma ekler.

# Add a new default configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

# Add a new aksManagedAutoUpgradeSchedule configuration
az aks maintenanceconfiguration add -g myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule --config-file ./autoUpgradeWindow.json

Mevcut bakım penceresini güncelleştirme

komutunu kullanarak mevcut bakım yapılandırmasını güncelleştirin az aks maintenanceconfiguration update .

Aşağıdaki örnek, her Pazartesi 02:00 ile 03:00 arasında çalışacak şekilde default yapılandırmasını günceller:

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --weekday Monday --start-hour 2

Yapılandırma JSON dosyasını yeni bakım penceresi ayarlarıyla güncelleştirin.

Aşağıdaki örnek, bakımı her Pazartesi 02:00 ile 03:00 arasında çalışacak şekilde zamanlamak için önceki bölümdekidefault.jsongüncelleştirir:
```
{
  "timeInWeek": [
    {
      "day": "Monday",
      "hour_slots": [
        2,
        3
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}
```

az aks maintenanceconfiguration update komutunu --config-file parametresiyle kullanarak bakım penceresi yapılandırmasını güncelleştirin.

az aks maintenanceconfiguration update --resource-group myResourceGroup --cluster-name myAKSCluster --name default --config-file ./default.json

Mevcut kümedeki tüm bakım pencerelerini listeleme

KOMUTUNU kullanarak AKS kümenizdeki geçerli bakım yapılandırma pencerelerini listeleyin az aks maintenanceconfiguration list :

az aks maintenanceconfiguration list --resource-group myResourceGroup --cluster-name myAKSCluster

Var olan bir kümede belirli bir bakım yapılandırma penceresini gösterme

parametresiyle az aks maintenanceconfiguration show komutunu kullanarak --name AKS kümenizdeki belirli bir bakım yapılandırma penceresini görüntüleyin:

az aks maintenanceconfiguration show --resource-group myResourceGroup --cluster-name myAKSCluster --name aksManagedAutoUpgradeSchedule

Aşağıdaki örnek çıktı, aksManagedAutoUpgradeSchedule için bakım penceresini gösterir.

{
  "id": "/subscriptions/<subscription>/resourceGroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster/maintenanceConfigurations/aksManagedAutoUpgradeSchedule",
  "maintenanceWindow": {
    "durationHours": 4,
    "notAllowedDates": [
      {
        "end": "2024-01-05",
        "start": "2023-12-23"
      }
    ],
    "schedule": {
      "absoluteMonthly": {
        "dayOfMonth": 1,
        "intervalMonths": 3
      },
      "daily": null,
      "relativeMonthly": null,
      "weekly": null
    },
    "startDate": "2023-01-20",
    "startTime": "09:00",
    "utcOffset": "-08:00"
  },
  "name": "aksManagedAutoUpgradeSchedule",
  "notAllowedTime": null,
  "resourceGroup": "myResourceGroup",
  "systemData": null,
  "timeInWeek": null,
  "type": null
}

Mevcut kümedeki bakım yapılandırma penceresini silme

komutunu kullanarak az aks maintenanceconfiguration delete AKS kümenizdeki bir bakım yapılandırma penceresini silin.

Aşağıdaki örnek bakım yapılandırmasını siler autoUpgradeSchedule :

az aks maintenanceconfiguration delete --resource-group myResourceGroup --cluster-name myAKSCluster --name autoUpgradeSchedule