github.com/argoproj/argo-cd/v2@v2.10.9/docs/operator-manual/applicationset/Getting-Started.md (about)

     1  # Getting Started
     2  
     3  This guide assumes you are familiar with Argo CD and its basic concepts. See the [Argo CD documentation](../../core_concepts.md) for more information.
     4      
     5  ## Requirements
     6  
     7  * Installed [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/) command-line tool
     8  * Have a [kubeconfig](https://kubernetes.io/docs/tasks/access-application-cluster/configure-access-multiple-clusters/) file (default location is `~/.kube/config`).
     9  
    10  ## Installation
    11  
    12  There are a few options for installing the ApplicationSet controller.
    13  
    14  
    15  ### A) Install ApplicationSet as part of Argo CD
    16  
    17  Starting with Argo CD v2.3, the ApplicationSet controller is bundled with Argo CD. It is no longer necessary to install the ApplicationSet controller separately from Argo CD.
    18  
    19  Follow the [Argo CD Getting Started](../../getting_started.md) instructions for more information.
    20  
    21  
    22  
    23  ### B) Install ApplicationSet into an existing Argo CD install (pre-Argo CD v2.3)
    24  
    25  **Note**: These instructions only apply to versions of Argo CD before v2.3.0.
    26  
    27  The ApplicationSet controller *must* be installed into the same namespace as the Argo CD it is targeting.
    28  
    29  Presuming that Argo CD is installed into the `argocd` namespace, run the following command:
    30  
    31  ```bash
    32  kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/applicationset/v0.4.0/manifests/install.yaml
    33  ```
    34  
    35  Once installed, the ApplicationSet controller requires no additional setup.
    36  
    37  The `manifests/install.yaml` file contains the Kubernetes manifests required to install the ApplicationSet controller:
    38  
    39  - CustomResourceDefinition for `ApplicationSet` resource
    40  - Deployment for `argocd-applicationset-controller`
    41  - ServiceAccount for use by ApplicationSet controller, to access Argo CD resources
    42  - Role granting RBAC access to needed resources, for ServiceAccount
    43  - RoleBinding to bind the ServiceAccount and Role
    44  
    45  
    46  <!-- ### C) Install development builds of ApplicationSet controller for access to the latest features
    47  
    48  Development builds of the ApplicationSet controller can be installed by running the following command:
    49  ```bash
    50  kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/applicationset/master/manifests/install.yaml
    51  ```
    52  
    53  With this option you will need to ensure that Argo CD is already installed into the `argocd` namespace.
    54  
    55  How it works:
    56  
    57  - After each successful commit to *argoproj/applicationset* `master` branch, a GitHub action will run that performs a container build/push to [`argoproj/argocd-applicationset:latest`](https://quay.io/repository/argoproj/argocd-applicationset?tab=tags )
    58  - [Documentation for the `master`-branch-based developer builds](https://argocd-applicationset.readthedocs.io/en/master/)  is available from Read the Docs.
    59  
    60  !!! warning
    61      Development builds contain newer features and bug fixes, but are more likely to be unstable, as compared to release builds.
    62  
    63  See the `master` branch [Read the Docs](https://argocd-applicationset.readthedocs.io/en/master/) page for documentation on post-release features. -->
    64  
    65  
    66  <!-- ## Upgrading to a Newer Release
    67  
    68  To upgrade from an older release (eg 0.1.0, 0.2.0) to a newer release (eg 0.3.0), you only need to `kubectl apply` the `install.yaml` for the new release, as described under *Installation* above.
    69  
    70  There are no manual upgrade steps required between any release of ApplicationSet controller, (including 0.1.0, 0.2.0, and 0.3.0) as of this writing, however, see the behaviour changes in ApplicationSet controller v0.3.0, below.
    71  
    72  ### Behaviour changes in ApplicationSet controller v0.3.0
    73  
    74  There are no breaking changes, however, a couple of behaviours have changed from v0.2.0 to v0.3.0. See the [v0.3.0 upgrade page](upgrading/v0.2.0-to-v0.3.0.md) for details. -->
    75  ## Enabling high availability mode
    76  
    77  To enable high availability, you have to set the command ``` --enable-leader-election=true  ``` in argocd-applicationset-controller container and increase the replicas. 
    78  
    79  do following changes in manifests/install.yaml
    80  
    81  ```bash
    82      spec:
    83        containers:
    84        - command:
    85          - entrypoint.sh
    86          - argocd-applicationset-controller
    87          - --enable-leader-election=true
    88  ```
    89  
    90  ### Optional: Additional Post-Upgrade Safeguards
    91  
    92  See the [Controlling Resource Modification](Controlling-Resource-Modification.md) page for information on additional parameters you may wish to add to the ApplicationSet Resource in `install.yaml`, to provide extra security against any initial, unexpected post-upgrade behaviour. 
    93  
    94  For instance, to temporarily prevent the upgraded ApplicationSet controller from making any changes, you could:
    95  
    96  - Enable dry-run
    97  - Use a create-only policy
    98  - Enable `preserveResourcesOnDeletion` on your ApplicationSets
    99  - Temporarily disable automated sync in your ApplicationSets' template
   100  
   101  These parameters would allow you to observe/control the behaviour of the new version of the ApplicationSet controller in your environment, to ensure you are happy with the result (see the ApplicationSet log file for details). Just don't forget to remove any temporary changes when you are done testing!
   102  
   103  However, as mentioned above, these steps are not strictly necessary: upgrading the ApplicationSet controller should be a minimally invasive process, and these are only suggested as an optional precaution for extra safety.
   104  
   105  ## Next Steps
   106  
   107  Once your ApplicationSet controller is up and running, proceed to [Use Cases](Use-Cases.md) to learn more about the supported scenarios, or proceed directly to [Generators](Generators.md) to see example `ApplicationSet` resources.