argo-cd/docs/user-guide/compare-options.md

# Compare Options

## Ignoring Resources That Are Extraneous

>v1.1

You may wish to exclude resources from the app's overall sync status under certain circumstances. E.g. if they are generated by a tool. This can be done by adding this annotation on the resource you wish to exclude:

```yaml
metadata:
  annotations:
    argocd.argoproj.io/compare-options: IgnoreExtraneous
```

![compare option needs pruning](../assets/compare-option-ignore-needs-pruning.png)

!!! note
    This only affects the sync status. If the resource's health is degraded, then the app will also be degraded.

Kustomize has a feature that allows you to generate config maps ([read more ⧉](https://github.com/kubernetes-sigs/kustomize/blob/master/examples/configGeneration.md)). You can set `generatorOptions` to add this annotation so that your app remains in sync:

```yaml
configMapGenerator:
  - name: my-map
    literals:
      - foo=bar
generatorOptions:
  annotations:
    argocd.argoproj.io/compare-options: IgnoreExtraneous
kind: Kustomization
``` 
 
!!! note
    `generatorOptions` adds annotations to both config maps and secrets ([read more ⧉](https://github.com/kubernetes-sigs/kustomize/blob/master/examples/generatorOptions.md)).
    
You may wish to combine this with the [`Prune=false` sync option](sync-options.md).
Adds Prune=false and IgnoreExtraneous options (#1680) 2019-06-07 15:46:11 +00:00			`# Compare Options`

			`## Ignoring Resources That Are Extraneous`

Adds Validate=false that disables validation when applying resources.… (#1750) 2019-06-18 21:07:26 +00:00			`>v1.1`

docs: declare where to add the annotation (#4490) We got bitten by thinking that this annotation could possibly added to the application to exclude all extraneous resources (see #4487). The annotation must be added to the resource we wish to exclude. 2020-10-06 06:12:35 +00:00			`You may wish to exclude resources from the app's overall sync status under certain circumstances. E.g. if they are generated by a tool. This can be done by adding this annotation on the resource you wish to exclude:`
Adds Prune=false and IgnoreExtraneous options (#1680) 2019-06-07 15:46:11 +00:00
			```yaml
			`metadata:`
			`annotations:`
			`argocd.argoproj.io/compare-options: IgnoreExtraneous`
			```

			`![compare option needs pruning](../assets/compare-option-ignore-needs-pruning.png)`

			`!!! note`
			`This only affects the sync status. If the resource's health is degraded, then the app will also be degraded.`

			Kustomize has a feature that allows you to generate config maps ([read more ⧉](https://github.com/kubernetes-sigs/kustomize/blob/master/examples/configGeneration.md)). You can set `generatorOptions` to add this annotation so that your app remains in sync:

			```yaml
			`configMapGenerator:`
			`- name: my-map`
			`literals:`
			`- foo=bar`
			`generatorOptions:`
			`annotations:`
			`argocd.argoproj.io/compare-options: IgnoreExtraneous`
			`kind: Kustomization`
			```

			`!!! note`
			`generatorOptions` adds annotations to both config maps and secrets ([read more ⧉](https://github.com/kubernetes-sigs/kustomize/blob/master/examples/generatorOptions.md)).

			You may wish to combine this with the [`Prune=false` sync option](sync-options.md).