Project sync windows (SyncWindow) in ArgoCD

• Sync windows are configurable windows of time where syncs will either be blocked or allowed.
• These are defined by a kind, which can be either allow or deny, a schedule in cron format and a duration along with one or more of either applications, namespaces and clusters.
• Wildcards are supported.
• These windows affect the running of both manual and automated syncs but allow an override for manual syncs which is useful if you are only interested in preventing automated syncs or if you need to temporarily override a window to perform a sync.

The windows work in the following way.

• If there are no windows matching an application then all syncs are allowed.
• If there are any allow windows matching an application then syncs will only be allowed when there is an active allow windows.
• If there are any deny windows matching an application then all syncs will be denied when the deny windows are active.
• If there is an active matching allow and an active matching deny then syncs will be denied as deny windows override allow windows.

The UI and the CLI will both display the state of the sync windows. The UI has a panel which will display different colours depending on the state. The colours are as follows. Red: sync denied, Orange: manual allowed and Green: sync allowed.

How to apply Sync Windows

$ argocd proj windows add devopsschool \
    --kind allow \
    --schedule "0 22 * * *" \
    --duration 1h \
    --applications "*"

Alternatively, they can be created directly in the AppProject manifest:

apiVersion: argoproj.io/v1alpha1
kind: AppProject
metadata:
  name: default
spec:
  syncWindows:
  - kind: allow
    schedule: '10 1 * * *'
    duration: 1h
    applications:
    - '*-prod'
    manualSync: true
  - kind: deny
    schedule: '0 22 * * *'
    duration: 1h
    namespaces:
    - default
   - kind: allow
     schedule: '0 23 * * *'
     duration: 1h
     clusters:
     - in-cluster
     - cluster1

To allow manual syncs using the CLI, UI or directly in the AppProject manifest:
$ argocd proj windows enable-manual-sync PROJECT ID

To disable
$ argocd proj windows disable-manual-sync PROJECT ID

Windows can be listed using the CLI or viewed in the UI:
$ argocd proj windows list PROJECT

• Author
• Recent Posts

Follow me

Rajesh Kumar

Mentor for DevOps - DevSecOps - SRE - Cloud - Container & Micorservices at Software AG

Join my following certification courses...
- DevOps Certified Professionals (DCP)
- Site Reliability Engineering Certified Professionals (SRECP)
- Master in DevOps Engineering (MDE)
- DevSecOps Certified Professionals (DSOCP)
URL - https://www.devopsschool.com/certification/

My Linkedin - https://www.linkedin.com/in/rajeshkumarin

Follow me

Latest posts by Rajesh Kumar (see all)

• Best AI tools for Software Engineers - November 4, 2024
• Installing Jupyter: Get up and running on your computer - November 2, 2024
• An Introduction of SymOps by SymOps.com - October 30, 2024