# Annotated Application View

Argo CD Instances don't fall under the category of 'Deployment Target', and don't support the idea of 'Target Tags',
instead - Argo CD *Applications* are annotated with [Scoping Annotations](/docs/argo-cd/annotations) to provide a similar
mapping between project/environment and an output location (in this case, an Argo Application's repository).

As this data isn't readily visible during the step - we've added a drawer so you can see what applications will be updated
given current Argo CD Application annotations.

This data is also visible via the Octopus Infrastructure pages - but having it on hand can make the process simpler.

## Argo App Configuration

When you create a new Argo step, you'll see in the Output section, a field titled `Argo CD Applications`.
The content of this field is dependent on the state of your system:

- Have you already registered a gateway and Argo CD Instance?
- If not, you will see the following - selecting the button will start the gateway registration process.
  
:::figure
![Deployment Preview With No Argo CD Gateways Registered](/docs/img/argo-cd/deployment-preview-no-argocd.png)
:::

- Have you applied Scoping annotations to any applications?
  - If not, you will need to add scoping annotations to your application(s).
  - You will see the following - selecting the button will open a drawer to aid in the creation of necessary annotation text

    :::figure
    ![Deployment Preview No Apps Mapped](/docs/img/argo-cd/deplpyment-preview-no-apps.png)
    :::

  - If you do have the annotations - you'll be presented a button which will open the 'Deployment Preview' drawer when selected

    :::figure
    ![Deployment Preview Button](/docs/img/argo-cd/deployment-preview-button.png)
    :::

  - Are git credentials available for all detected git repositories?
    - If not, you will see a warning triangle next to the application
    - A "Connect Git Credential" will appear next to the repository lacking credentials
    - Selecting this button will let you create a new git credential, or add this url to an existing credential

    :::figure
    ![Deployment Preview Drawer No Git Creds](/docs/img/argo-cd/deployment-preview-no-git-creds.png)
    :::

  - Once all preconditions are met, you'll see a Deployment Preview drawer, with no errors/warnings.
  - You're free to deploy (and you can be confident which Applications are going to be updated).

    :::figure
    ![Deployment Preview Drawer](/docs/img/argo-cd/deployment-preview-drawer.png)
    :::