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

Makale
08/02/2024

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. 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 bkz . AKS kümesi oluşturma.
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 veya notAllowedDates dönemleri sırasında notAllowedTime bile ç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. Yapılandırmaya kıyasla default bu yapılandırmayla daha ayrıntılı denetimli tempo ve yinelenme ayarları 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 zamanlanan düğüm işletim sistemi güvenlik düzeltme eki uygulama zamanlarını denetler. Yapılandırmaya kıyasla default bu yapılandırmayla daha ayrıntılı denetimli tempo ve yinelenme ayarları 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 eki uygulama ve güncelleştirme.

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

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

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):

Veri Akışı Adı	Veri Akışı Açıklaması	Default value
`timeInWeek`	Bir `default` yapılandırmada, bu özellik bir bakım penceresi tanımlayan ve `hourSlots` değerlerini içerir`day`.	Uygulanamaz
`timeInWeek.day`	Bir yapılandırmada `default` bakım yapmak için haftanın 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`	Bakımın çalıştırılamıyabileceği, ve `end` alt özellikleri tarafından `start` belirlenen 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:

Veri Akışı Adı	Veri Akışı Açıklaması	Default value
`utcOffset`	Küme bakımı için 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ıştırmaları için gün cinsinden aralık. Yalnızca için `aksManagedNodeOSUpgradeSchedule`geçerlidir.	Uygulanamaz
`intervalWeeks`	Bakım çalıştırmaları için hafta cinsinden aralık.	Uygulanamaz
`intervalMonths`	Bakım çalıştırmaları için ay cinsinden aralık.	Uygulanamaz
`dayOfWeek`	Bakımın başlaması için belirtilen haftanın günü.	Uygulanamaz
`durationHours`	Bakımın çalıştırılması için pencerenin süresi.	Uygulanamaz
`notAllowedDates`	Bakımın çalıştırılamıyabileceği, ve `end` alt özellikleri tarafından `start` belirlenen tarih aralığı. Bu yalnızca bir yapılandırma dosyası kullanarak bakım penceresi oluştururken geçerlidir.	Uygulanamaz

Zamanlama türleri

Kullanılabilir dört zamanlama türü vardır: Daily, Weekly, AbsoluteMonthlyve RelativeMonthly.

Weekly, AbsoluteMonthlyve RelativeMonthly zamanlama türleri yalnızca ve aksManagedNodeOSUpgradeSchedule yapılandırmaları için aksManagedClusterAutoUpgradeSchedule geçerlidir. Daily zamanlamaları yalnızca yapılandırmalar için aksManagedNodeOSUpgradeSchedule geçerlidir.

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

Zamanlama Weekly "Cuma günü iki haftada bir" gibi görünebilir:

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

Zamanlama AbsoluteMonthly "ayın ilk gününde üç ayda bir" gibi görünebilir:

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

Zamanlama RelativeMonthly "son Pazartesi günü iki ayda bir" 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ı ekleme

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, saat diliminde 12:00 ile 08:UTC+5:3000 arasında üçüncü Cuma günü çalışacak şekilde bakım zamanlayan yeni aksManagedAutoUpgradeSchedule bir 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 default türü kullanırken, bir gün içinde istediğiniz zaman bakım yapmak için parametresini atlayabilirsiniz --start-time .

Parametreleri kullanmak yerine bakım yapılandırması oluşturmak için bir JSON dosyası kullanabilirsiniz. Bu yöntemi kullandığınızda, yapılandırmalar ve aksManagedAutoUpgradeSchedule notAllowedDates yapılandırmalar için default belirterek notAllowedTimes çeşitli tarihler sırası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 UTC bakımı 01:00 ile 03:00 arasında çalışacak şekilde zamanlayan bir default.json dosya oluşturur. Ayrıca, bakım penceresiyle çakışsa bile, bakımın izin verilmediği bir durum 2021-05-26T03:00:00Z 2021-05-30T12:00:00Z 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, saat diliminde 09:00 ile 13:UTC-0800 arasında ayın ilkinde üç ayda bir çalışacak şekilde bakım zamanlayan bir autoUpgradeWindow.json dosya oluşturur. Ayrıca, bakım penceresiyle çakışsa bile, bakımın izin verilmediği bir durum 2023-12-23 2024-01-05 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"
            }
        ]
    }
  }
}

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

İlk örnek, dosyasını kullanarak default.json yeni default bir yapılandırma ekler. İkinci örnek, dosyasını kullanarak autoUpgradeWindow.json yeni aksManagedAutoUpgradeSchedule bir 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 yapılandırmayı güncelleştirir default :

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ümdeki dosyayı güncelleştirirdefault.json:
```
{
  "timeInWeek": [
    {
      "day": "Monday",
      "hour_slots": [
        2,
        3
      ]
    }
  ],
  "notAllowedTime": [
    {
      "start": "2021-05-26T03:00:00Z",
      "end": "2021-05-30T12:00:00Z"
    }
  ]
}
```

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

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 --name komutunu kullanarak az aks maintenanceconfiguration show 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ı, için aksManagedAutoUpgradeSchedulebakı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