diff --git a/modules/gitops-argo-cd-properties.adoc b/modules/gitops-argo-cd-properties.adoc index 773bddf6de2d..a99d515c9e21 100644 --- a/modules/gitops-argo-cd-properties.adoc +++ b/modules/gitops-argo-cd-properties.adoc @@ -9,136 +9,133 @@ The Argo CD Custom Resource consists of the following properties: |=== -|*Name* |*Description* |*Default* | *Properties* -|`ApplicationInstanceLabelKey` |The `metadata.label` key name where Argo CD injects the app name as a tracking label.|`app.kubernetes.io/instance` | +|**Name** |**Description** |**Default** | **Properties** +|`applicationInstanceLabelKey` |The `metadata.label` key name where Argo CD injects the app name as a tracking label.|`app.kubernetes.io/instance` | -|`ApplicationSet` -|`ApplicationSet` controller configuration options. -| `__` -a|* __ - The container image for the `ApplicationSet` controller. This overrides the `ARGOCD_APPLICATIONSET_IMAGE` environment variable. - * __ - The tag to use with the `ApplicationSet` container image. - * __ - The container compute resources. - * __ - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. - * __ - The log format used by the Argo CD Application Controller component. Valid options are `text` or `json`. - * __ - The kubectl parallelism limit to set for the controller `(--kubectl-parallelism-limit flag)`. - -|`ConfigManagementPlugins` |Add a configuration management plugin.| `____` | +|`applicationSet` +|`applicationSet` controller configuration options. +| `__` +a|* `` - The container image for the `applicationSet` controller. This overrides the `ARGOCD_APPLICATIONSET_IMAGE` environment variable. + * `` - The tag to use with the `applicationSet` container image. + * `` - The container compute resources. + * `` - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. + * `` - The log format used by the Argo CD Application Controller component. Valid options are `text` or `json`. + * `` - The kubectl parallelism limit to set for the controller (`--kubectl-parallelism-limit` flag). + +|`configManagementPlugins` |Add a configuration management plugin.| `____` | + +|`controller` |Argo CD Application Controller options.| `____` +a|* `` - The number of operation processors. + * `` - The number of status processors. + * `` - The container compute resources. + * `` - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. + * `` - AppSync is used to control the sync frequency of Argo CD applications. + * `` - Enable sharding on the Argo CD Application Controller component. Use this property to manage a large number of clusters and relieve memory pressure on the controller component. + * `` - The number of replicas that are used to support sharding of the Argo CD Application Controller. + * `` - Enable dynamic scaling of the Argo CD Application Controller component. Use this property to allow the Operator to scale the number of replicas based on the number of clusters the controller component is managing presently. Setting this property to `true` overrides the configuration of the `sharding.enabled` and `sharding.replicas` properties. + * `` - The minimum number of Argo CD Application Controller replicas. + * `` - The maximum number of Argo CD Application Controller replicas. + * `` - The number of clusters that need to be managed by each shard. When the replica count reaches the `maxShards`, the shards manage more than one cluster. + * `` - Environment to set for the application controller workloads. + +|`disableAdmin` |Disables the built-in admin user.|`false` | + +|`gaTrackingID` |Use a Google Analytics tracking ID.|`____` | + +|`gaAnonymizeUsers` |Enable hashed usernames sent to google analytics.|`false` | + +|`ha` |High availablity options.| `____` +a|* `` - Toggle high availability support globally for Argo CD. + * `` - The Redis HAProxy container image. This overrides the `ARGOCD_REDIS_HA_PROXY_IMAGE` environment variable. + * `` - The tag to use for the Redis HAProxy container image. + +|`helpChatURL` |URL for getting chat help (this is typically your Slack channel for support).|`https://mycorp.slack.com/argo-cd` | + +|`helpChatText` |The text that appears in a text box for getting chat help.|`Chat now!`| + +|`image` |The container image for all Argo CD components. This overrides the `ARGOCD_IMAGE` environment variable.|`argoproj/argocd` | + +|`ingress` |Ingress configuration options.| `____` | + +|`initialRepositories` |Initial Git repositories to configure Argo CD to use upon creation of the cluster.|`____` | + +|`notifications` |Notifications controller configuration options.|`____` +a|* `` - The toggle to start the notifications-controller. + * `` - The container image for all Argo CD components. This overrides the `ARGOCD_IMAGE` environment variable. + * `` - The tag to use with the Notifications container image. + * `` - The container compute resources. + * `` - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. + +|`repositoryCredentials` |Git repository credential templates to configure Argo CD to use upon creation of the cluster.| `____` | + +|`initialSSHKnownHosts` |Initial SSH Known Hosts for Argo CD to use upon creation of the cluster.| `____` | + +|`kustomizeBuildOptions` |The build options and parameters to use with `kustomize build`.|`____` | + +|`oidcConfig` |The OIDC configuration as an alternative to Dex.|`____` | + +|`nodePlacement` |Add the `nodeSelector` and the `tolerations`.|`____` | + +|`prometheus` |Prometheus configuration options.|`____` +a|* `` - Toggle Prometheus support globally for Argo CD. + * `` - The hostname to use for Ingress or Route resources. + * `` - Toggles Ingress for Prometheus. + * `` - Route configuration options. + * `` - The replica count for the Prometheus `StatefulSet`. + +|`rbac` |RBAC configuration options.|`____` +a|* `` - The `policy.default` property in the `argocd-rbac-cm` config map. The name of the default role which Argo CD falls back to when authorizing API requests. + * `` - The `policy.csv` property in the `argocd-rbac-cm` config map. CSV data containing user-defined RBAC policies and role definitions. + * `` - The scopes property in the `argocd-rbac-cm` config map. Controls which OIDC scopes to examine during RBAC enforcement, in addition to sub scope. + +|`redis` |Redis configuration options.|`____` +a|* `` - Use the provider to create the Redis server's TLS certificate. Only the `openshift` value is currently available. + * `` - Defines whether the Redis server should be accessed using strict TLS validation. + * `` - The container image for Redis. This overrides the `ARGOCD_REDIS_IMAGE` environment variable. + * `` - The container compute resources. + * `` - The tag to use with the Redis container image. + +|`resourceHealthChecks` |Customize resource health check behavior.|`____` | +|`resourceIgnoreDifferences` |Customize resource ignore difference behavior.|`____` | + +|`resourceActions` |Customize resource action behavior.|`____` | + +|`resourceExclusions` |Completely ignore entire classes of resource group.|`____` | + +|`resourceInclusions` |The configuration to identify which resource group/kinds are applied.|`____` | + +|`server` |Argo CD Server configuration options.|`____` +a|* `` - Server autoscale configuration options. + * `` - List of arguments added to the existing arguments set by the Operator. + * `` - gRPC configuration options. + * `` - The hostname used for Ingress or Route resources. + * `` - Ingress configuration for the Argo CD server component. + * `` - Toggles the insecure flag for Argo CD server. + * `` - The container compute resources. + * `` - The number of replicas for the Argo CD server. Must be greater than or equal to `0`. If `autoscale` is enabled, `replicas` is ignored. + * `` - Route configuration options. + * `` - The `serviceType` used for the service resource. + * `` - The log level to be used by the Argo CD Server component. Valid options are `debug`, `info`, `error`, and `warn`. + * `` - The log format used by the Argo CD Application Controller component. Valid options are `text` or `json`. + * `` - Environment to set for the server workloads. -|`Controller` |Argo CD Application Controller options.| `____` -a|* __ - The number of operation processors. - * __ - The number of status processors. - * __ - The container compute resources. - * __ - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. - * __ - AppSync is used to control the sync frequency of Argo CD applications - * __ - Enable sharding on the Argo CD Application Controller component. This property is used to manage a large number of clusters to relieve memory pressure on the controller component. - * __ - The number of replicas that will be used to support sharding of the Argo CD Application Controller. - * __ - Enable dynamic scaling of the Argo CD Application Controller component. Use this property to allow the Operator to scale the number of replicas based on the number of clusters the controller component is managing presently. Setting this property to `true` overrides the configuration of the `Sharding.enabled` and `Sharding.replicas` properties. - * __ - The minimum number of Argo CD Application Controller replicas. - * __ - The maximum number of Argo CD Application Controller replicas. - * __ - The number of clusters that need to be managed by each shard. When the replica count reaches the `maxShards`, the shards manage more than one cluster. - * __ - Environment to set for the application controller workloads. +|`sso` |Single Sign-on options.|`____` +a|* `` - Configuration options for Keycloak SSO provider. + * `` - Configuration options for Dex SSO provider. + * `` - The name of the provider used to configure Single Sign-on. Currently, the supported options are Dex and Keycloak. + +|`statusBadgeEnabled` |Enable application status badge.|`true` | -|`DisableAdmin` |Disables the built-in admin user.|`false` | - -|`GATrackingID` |Use a Google Analytics tracking ID.|`____` | - -|`GAAnonymizeusers` |Enable hashed usernames sent to Google Analytics.|`false` | - -|`HA` |High availablity options.| `____` -a|* __ - Toggle high availability support globally for Argo CD. - * __ - The Redis HAProxy container image. This overrides the `ARGOCD_REDIS_HA_PROXY_IMAGE` environment variable. - * __ - The tag to use for the Redis HAProxy container image. - -|`HelpChatURL` |URL for getting chat help (this will typically be your Slack channel for support).|`https://mycorp.slack.com/argo-cd` | - -|`HelpChatText` |The text that appears in a text box for getting chat help.|`Chat now!`| - -|`Image` |The container image for all Argo CD components. This overrides the `ARGOCD_IMAGE` environment variable.|`argoproj/argocd` | - -|`Ingress` |Ingress configuration options.| `____` | - -|`InitialRepositories` |Initial Git repositories to configure Argo CD to use upon creation of the cluster.|`____` | - -|`Notifications` |Notifications controller configuration options.|`____` -a|* __ - The toggle to start the notifications-controller. - * __ - The container image for all Argo CD components. This overrides the `ARGOCD_IMAGE` environment variable. - * __ - The tag to use with the Notifications container image. - * __ - The container compute resources. - * __ - The log level used by the Argo CD Application Controller component. Valid options are `debug`, `info`, `error`, and `warn`. - -|`RepositoryCredentials` |Git repository credential templates to configure Argo CD to use upon creation of the cluster.| `____` | - -|`InitialSSHKnownHosts` |Initial SSH Known Hosts for Argo CD to use upon creation of the cluster.| `____` | - -|`KustomizeBuildOptions` |The build options and parameters to use with `kustomize build`.|`____` | - -|`OIDCConfig` |The OIDC configuration as an alternative to Dex.|`____` | - -|`NodePlacement` |Add the `nodeSelector` and the `tolerations`.|`____` | - -|`Prometheus` |Prometheus configuration options.|`____` -a|* __ - Toggle Prometheus support globally for Argo CD. - * __ - The hostname to use for Ingress or Route resources. - * __ - Toggles Ingress for Prometheus. - * __ - Route configuration options. - * __ - The replica count for the Prometheus `StatefulSet`. - -|`RBAC` |RBAC configuration options.|`____` -a|* __ - The `policy.default` property in the `argocd-rbac-cm` config map. The name of the default role which Argo CD will fall back to, when authorizing API requests. - * __ - The `policy.csv` property in the `argocd-rbac-cm` config map. CSV data containing user-defined RBAC policies and role definitions. - * __ - The scopes property in the `argocd-rbac-cm` config map. Controls which OIDC scopes to examine during RBAC enforcement (in addition to sub scope). - -|`Redis` |Redis configuration options.|`____` -a|* __ - Use the provider to create the Redis server's TLS certificate (one of: openshift). Currently only available for {OCP}. - * __ - Define whether the Redis server should be accessed using strict TLS validation. - * __ - The container image for Redis. This overrides the `ARGOCD_REDIS_IMAGE` environment variable. - * __ - The container compute resources. - * __ - The tag to use with the Redis container image. - -|`ResourceHealthChecks` |Customize resource health check behavior.|`____` | -|`ResourceIgnoreDifferences` |Customize resource ignore difference behavior.|`____` | - -|`ResourceActions` |Customize resource action behavior.|`____` | - -|`ResourceExclusions` |Completely ignore entire classes of resource group.|`____` | - -|`ResourceInclusions` |The configuration to configure which resource group/kinds are applied.|`____` | - -|`Server` |Argo CD Server configuration options.|`____` -a|* __ - Server autoscale configuration options. - * __ - List of arguments added to the existing arguments set by the Operator. - * __ - GRPC configuration options. - * __ - The hostname used for Ingress or Route resources. - * __ - Ingress configuration for the Argo CD server component. - * __ - Toggles the insecure flag for Argo CD server. - * __ - The container compute resources. - * __ - The number of replicas for the Argo CD server. Must be greater than or equal to `0`. If `Autoscale` is enabled, `Replicas` is ignored. - * __ - Route configuration options. - * __ - The `ServiceType` used for the service resource. - * __ - The log level to be used by the Argo CD Server component. Valid options are `debug`, `info`, `error`, and `warn`. - * __ - The log format used by the Argo CD Application Controller component. Valid options are `text` or `json`. - * __ - Environment to set for the server workloads. - -|`SSO` |Single Sign-on options.|`____` -a|* __ - Configuration options for Keycloak SSO provider. - * __ - Configuration options for Dex SSO provider. - * __ - The name of the provider used to configure Single Sign-on. For now the supported options are Dex and Keycloak. - -|`StatusBadgeEnabled` |Enable application status badge.|`true` | - -|`TLS` |TLS configuration options.|`____` -a|* __ - The name of the `ConfigMap` which contains the CA certificate. - * __ - The name of the secret which contains the CA Certificate and Key. - * __ - Initial set of certificates in the `argocd-tls-certs-cm` config map for connecting Git repositories via HTTPS. - -|`UserAnonyousEnabled` |Enable anonymous user access.|`true` | - -|`Version` |The tag to use with the container image for all Argo CD components.|Latest Argo CD version| - -|`Banner` |Add a UI banner message.|`____` -a|* __ - The banner message content (required if a banner is displayed). - * __ - The banner message link URL (optional). -|=== +|`tls` |TLS configuration options.|`____` +a|* `` - The name of the `ConfigMap` which contains the CA certificate. + * `` - The name of the secret which contains the CA certificate and key. + * `` - Initial set of certificates in the `argocd-tls-certs-cm` config map for connecting Git repositories through HTTPS. +|`usersAnonymousEnabled` |Enable anonymous user access.|`true` | +|`version` |The tag to use with the container image for all Argo CD components.|Latest Argo CD version| +|`banner` |Add a UI banner message.|`____` +a|* `` - The banner message content (required if a banner is displayed). + * `` - The banner message link URL (optional). +|=== \ No newline at end of file diff --git a/modules/gitops-repo-server-properties.adoc b/modules/gitops-repo-server-properties.adoc index 63919c5a6d69..7faffd41a817 100644 --- a/modules/gitops-repo-server-properties.adoc +++ b/modules/gitops-repo-server-properties.adoc @@ -9,19 +9,19 @@ The following properties are available for configuring the Repo server component: |=== -|*Name* |*Default* | *Description* -|`Resources` |`____` |The container compute resources. -|`MountSAToken` |`false` |Whether the `ServiceAccount` token should be mounted to the repo-server pod. -|`ServiceAccount` |`""` |The name of the `ServiceAccount` to use with the repo-server pod. -|`VerifyTLS` |`false` |Whether to enforce strict TLS checking on all components when communicating with repo server. -|`AutoTLS` |`""` |Provider to use for setting up TLS the repo-server's gRPC TLS certificate (one of: openshift). Currently only available for OpenShift. -|`Image` | `argoproj/argocd` |The container image for Argo CD Repo server. This overrides the `ARGOCD_REPOSERVER_IMAGE` environment variable. -|`Version` | same as `.spec.Version` |The tag to use with the Argo CD Repo server. -|`LogLevel` | `info` |The log level used by the Argo CD Repo server. Valid options are debug, info, error, and warn. -|`LogFormat` | `text` |The log format to be used by the Argo CD Repo server. Valid options are text or json. -|`ExecTimeout` | `180` |Execution timeout in seconds for rendering tools (e.g. Helm, Kustomize). -|`Env` | `____` |Environment to set for the repository server workloads. -|`Replicas` | `____` |The number of replicas for the Argo CD Repo server. Must be greater than or equal to `0`. +|**Name** |**Default** | **Description** +|`resources` |`____` |The container compute resources. +|`mountsatoken` |`false` |Defines whether the `serviceaccount` token should be mounted to the repo-server pod. +|`serviceaccount` |`""` |The name of the `serviceaccount` to use with the repo-server pod. +|`verifytls` |`false` |Defines whether to enforce strict TLS checking on all components when communicating with repo server. +|`autotls` |`""` |Provider to use for setting up TLS for the repo-server's gRPC TLS certificate. Currently, only the `openshift` value is acceptable. +|`image` | `argoproj/argocd` |The container image for Argo CD Repo server. This overrides the `ARGOCD_REPOSERVER_IMAGE` environment variable. +|`version` | same as `.spec.Version` |The tag to use with the Argo CD Repo server. +|`logLevel` | `info` |The log level used by the Argo CD Repo server. Valid options are `debug`, `info`, `error`, and `warn`. +|`logFormat` | `text` |The log format to be used by the Argo CD Repo server. Valid options are `text` or `json`. +|`execTimeout` | `180` |Execution timeout in seconds for rendering tools (for example Helm or Kustomize). +|`env` | `____` |Environment to set for the repository server workloads. +|`replicas` | `____` |The number of replicas for the Argo CD Repo server. Must be greater than or equal to `0`. |===