Tüm Ürünler
Search
Belge Merkezi

Container Service for Kubernetes:Create CronJobs for scheduled tasks

Son Güncelleme:Oct 10, 2026

CronJob, Pod'ları doğrudan yönetmeyen bir iş yüküdür; belirli bir programa göre bağımsız Job örnekleri oluşturur ve durumlarını izler. Yedekleme, rapor oluşturma veya e-posta gönderme gibi periyodik görevler için kullanın. Bu konuda, konsolda veya kubectl ile nasıl CronJob oluşturulacağı gösterilmektedir.

ACK konsolunu veya kubectl kullanarak bir CronJob oluşturun.

Önemli

Örnek görüntüler herkese açıktır. Kümenizin bunları çekmek için İnternet erişimine ihtiyacı vardır:

  • [Mevcut bir küme için İnternet erişimini etkinleştirin](https://www.alibabacloud.com/help/en/document_detail/178480.html) (önerilir): Kümenin barındırıldığı Virtual Private Cloud (VPC) için genel bir NAT ağ geçidi oluşturun ve tüm kaynaklar için İnternet erişimini sağlayın.

  • [Düğümlere statik genel IP adresleri atayın](https://www.alibabacloud.com/help/en/document_detail/2858287.html): Genel IP adresine sahip düğümler genel görüntüleri çekebilir, ancak iş yükünü çalıştıran her düğümün bir genel IP adresine ihtiyacı vardır.

Ön koşullar

Konsol ile CronJob oluşturma

  1. ACK konsoluna giriş yapın. Sol gezinme bölmesinde, Clusters seçeneğine tıklayın.

  2. Clusters sayfasında, küme adınıza tıklayın. Sol bölmede, Workloads > CronJobs seçeneklerini belirleyin.

  3. CronJobs sayfasında, Create from Image seçeneğine tıklayın.

  4. Basic Information sayfasında temel ayarları yapılandırın ve Next seçeneğine tıklayarak Container sayfasına gidin.

  5. General bölümünde, Image Name alanını registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest olarak ayarlayın. Lifecycle bölümünde, Start parametresini yapılandırın. Next seçeneğine tıklayarak Advanced sayfasına gidin.

    • Command: /bin/sh

    • Parameter: ["-c", "echo 'starting...'; COUNTER=0; while [ $COUNTER -lt 5 ]; do sleep 2; COUNTER=$((COUNTER+1)); echo $COUNTER; done; echo 'finished'; exit 0"]

    Önemli

    Kümenin registry.cn-hangzhou.aliyuncs.com/acs-sample/nginx:latest görüntüsünü çekmesi için İnternet erişimine ihtiyacı vardır. Küme oluşturma sırasında Configure SNAT for VPC seçeneğini işaretlediyseniz bu özellik zaten etkindir. Aksi takdirde, küme için İnternet erişimini etkinleştirin.

    image.png

  6. Advanced sayfasında zamanlama ve görev ayarlarını yapılandırın. Bu örnek için zamanlamayı her 2 dakikada bir olarak ayarlayın ve diğer seçenekleri varsayılan değerlerinde bırakın. Create seçeneğine tıklayın.

    CronJob settings

    Parameter Description
    Schedule Sıklık. Hazır bir seçenek (saatlik, günlük, haftalık, aylık) seçin veya özel bir cron ifadesi girin (minute hour day-of-month month day-of-week). Bkz. Cron ifadesi sözdizimi.
    Concurrency policy Önceki görev hâlâ çalışırken yeni bir Job başlatılması gerektiğinde izlenecek davranış. Forbid: yeni Job'u atla (sıralı veya bağımlı görevler için). Allow: her ikisini de eş zamanlı çalıştır (bağımsız görevler için). Replace: çalışan Job'u sonlandır ve yeni bir tane başlat (yalnızca en son sonuç önemliyse).

    Job history

    Parameter Description
    Successful Jobs History Limit Saklanacak son başarılı Job sayısı. Daha eskileri silinir.
    Failed Jobs History Limit Saklanacak son başarısız Job sayısı.

    Job settings

    Parameter Kubernetes field Description Default
    Completions jobTemplate.spec.completions Job'un başarılı sayılması için tamamlanması gereken Pod sayısı. —
    Parallelism jobTemplate.spec.parallelism Eş zamanlı çalışabilecek maksimum Pod sayısı. —
    Timeout jobTemplate.spec.activeDeadlineSeconds Bir Job için maksimum çalışma süresi. Tamamlanma durumundan bağımsız olarak bu sınıra ulaşıldığında Job durur. 600 saniye
    BackoffLimit jobTemplate.spec.backoffLimit Job başarısız olarak işaretlenmeden önce tüm Pod'larda yapılacak maksimum yeniden deneme sayısı. 6
    Restart jobTemplate.spec.template.spec.restartPolicy Başarısızlık durumunda Pod yeniden başlatma davranışı. Never: Yeni bir Pod oluşturmadan konteyneri yerinde yeniden başlatır (yeniden başlatmalar backoffLimit sayısına dahil edilmez). On Failure: Başarısız olanın yerine yeni bir Pod oluşturur. —

    Labels, annotations

    Parameter Description
    Pod Labels Her Pod'a eklenen etiketler. ACK varsayılan olarak app: <application-name> ekler. Pod'ları iş yükleri ve hizmetlerle eşleştirmek için kullanılır.
    Pod Annotations Her Pod'a eklenen açıklamalar. Bazı ACK özellikleri belirli açıklamalar gerektirir.

    image.png

  7. Oluşturulduktan sonra Job'lar 2 dakikalık aralıklarla görünür.

    image.png

kubectl ile CronJob oluşturma

Önemli

Devam etmeden önce kubectl ile kümeye bağlanın.

  1. Aşağıdaki YAML kodunu cronjob.yaml olarak kaydedin. jobTemplate.spec yapısı, bağımsız bir Job spec'i ile aynıdır.

    apiVersion: batch/v1
    kind: CronJob
    metadata:
      name: example-cronjob
      labels:
        app: cronjob
    spec:
      schedule: "*/2 * * * *"           # Run every 2 minutes
      concurrencyPolicy: Forbid          # Skip new Job if previous one is still running
      successfulJobsHistoryLimit: 3      # Keep the 3 most recent successful Jobs
      failedJobsHistoryLimit: 2          # Keep the 2 most recent failed Jobs
      jobTemplate:
        spec:
          completions: 1                 # Job succeeds after 1 Pod completes
          parallelism: 1                 # Run one Pod at a time
          template:
            spec:
              containers:
              - name: counter
                image: anolis-registry.cn-zhangjiakou.cr.aliyuncs.com/openanolis/nginx:1.14.1-8.6
                command:
                - /bin/sh
                - -c
                - |
                  echo "starting...";
                  COUNTER=0;
                  while [ $COUNTER -lt 5 ]; do
                    sleep 2;
                    COUNTER=$((COUNTER+1));
                    echo "${COUNTER}";
                  done;
                  echo "finished";
                  exit 0
              restartPolicy: Never       # Do not restart the Pod on failure
  2. Manifest dosyasını uygulayın:

    kubectl apply -f cronjob.yaml

    Beklenen çıktı:

    cronjob.batch/example-cronjob created

CronJob'u doğrulama

CronJob'un programlandığı şekilde çalıştığını onaylayın.

  1. CronJob durumunu kontrol edin:

    kubectl get cronjob example-cronjob

    Beklenen çıktı:

    NAME               SCHEDULE      SUSPEND   ACTIVE   LAST SCHEDULE   AGE
    example-cronjob   */2 * * * *   False     0        <none>          15s

    SUSPEND değeri False olarak görünür; bu, CronJob'un aktif olduğu ve programlandığı şekilde tetiklendiği anlamına gelir.

  2. Yaklaşık 10 dakika sonra, CronJob tarafından oluşturulan Job'ları listeleyin:

    kubectl get job

    Beklenen çıktı:

    NAME                       STATUS     COMPLETIONS   DURATION   AGE
    example-cronjob-2901**22   Complete   1/1           31s        5m13s
    example-cronjob-2901**23   Complete   1/1           31s        3m13s
    example-cronjob-2901**24   Complete   1/1           26s        73s

    Job'lar 2 dakikalık aralıklarla görünür ve tamamlandıklarında Complete durumunu gösterir.

  3. Bir Job Pod'unun günlüklerini kontrol edin:

    # List Pods for the most recent Job
    kubectl get pods --selector=job-name=<job-name>
    
    # View logs
    kubectl logs <pod-name>

    <job-name> yerine yukarıdaki çıktidan bir Job adı girin (örneğin, example-cronjob-2901**24). Başarılı çıktının sonunda finished ifadesi yer alır.

Cron ifadesi sözdizimi

Bir cron ifadesi, boşlukla ayrılmış beş alandan oluşur:

# .---------------- minute (0–59)
# |  .------------- hour (0–23)
# |  |  .---------- day of month (1–31)
# |  |  |  .------- month (1–12)
# |  |  |  |  .---- day of week (0–6, Sunday to Saturday)
# |  |  |  |  |
  *  *  *  *  *

Yaygın kısaltma girişleri:

Entry Description Equivalent
@hourly Saatin başında saatte bir çalıştır 0 * * * *
@daily (veya @midnight) Gece yarısında günde bir çalıştır 0 0 * * *
@weekly Pazar günü gece yarısında haftada bir çalıştır 0 0 * * 0
@monthly Ayın ilk günü gece yarısında ayda bir çalıştır 0 0 1 * *
@yearly (veya @annually) 1 Ocak'ta gece yarısında yılda bir çalıştır 0 0 1 1 *

Cron ifadelerini oluşturmak ve doğrulamak için crontab.guru sitesini kullanın.

Sonraki adımlar