github.com/argoproj/argo-cd/v2@v2.10.5/docs/user-guide/skip_reconcile.md (about)

     1  # Skip Application Reconcile
     2  
     3  !!! warning "Alpha Feature"
     4      This is an experimental, alpha-quality feature.
     5      The primary use case is to provide integration with third party projects.
     6      This feature may be removed in future releases or modified in backwards-incompatible ways.
     7  
     8  Argo CD allows users to stop an Application from reconciling.
     9  The skip reconcile option is configured with the `argocd.argoproj.io/skip-reconcile: "true"` annotation.
    10  When the Application is configured to skip reconcile,
    11  all processing is stopped for the Application.
    12  During the period of time when the Application is not processing,
    13  the Application `status` field will not be updated.
    14  If an Application is newly created with the skip reconcile annotation,
    15  then the Application `status` field will not be present.
    16  To resume the reconciliation or processing of the Application,
    17  remove the annotation or set the value to `"false"`.
    18  
    19  See the below example for enabling an Application to skip reconcile:
    20  
    21  ```yaml
    22  metadata:
    23    annotations:
    24      argocd.argoproj.io/skip-reconcile: "true"
    25  ```
    26  
    27  See the below example for an Application that is newly created with the skip reconcile enabled:
    28  
    29  ```yaml
    30  apiVersion: argoproj.io/v1alpha1
    31  kind: Application
    32  metadata:
    33    annotations:
    34      argocd.argoproj.io/skip-reconcile: "true"
    35    name: guestbook
    36    namespace: argocd
    37  spec:
    38    destination:
    39      namespace: guestbook
    40      server: https://kubernetes.default.svc
    41    project: default
    42    source:
    43      path: guestbook
    44      repoURL: https://github.com/argoproj/argocd-example-apps.git
    45      targetRevision: HEAD
    46  ```
    47  
    48  The `status` field is not present.
    49  
    50  ## Primary Use Case
    51  
    52  The skip reconcile option is intended to be used with third party projects that wishes 
    53  to make updates to the Application status without having the changes being overwritten by the Application controller.
    54  An example of this usage is the [Open Cluster Management (OCM)](https://github.com/open-cluster-management-io/) project using 
    55  [pull-integration](https://github.com/open-cluster-management-io/argocd-pull-integration) controller.
    56  In the example, the hub cluster Application is not meant to be reconciled by the Argo CD Application controller.
    57  Instead, the OCM pull-integration controller will populate the primary/hub cluster Application status 
    58  using the collected Application status from the remote/spoke/managed cluster.
    59  
    60  ## Alternative Use Cases
    61  
    62  There are other alternative use cases for this skip reconcile option. 
    63  It's important to note that this is an experimental, alpha-quality feature 
    64  and the following use cases are generally not recommended.
    65  
    66  * Ease of debugging when the Application reconcile is skipped.
    67  * Orphan resources without deleting the Application might provide a safer way to migrate applications.
    68  * ApplicationSet can generate dry-run like Applications that don't reconcile automatically. 
    69  * Pause and resume Applications reconcile during a disaster recovery process.
    70  * Provide another alternative approval flow by not allowing an Application to start reconciling right away.