# Artifact

## Artifact

### Amazon S3

The following figure depicts the information to be provided to add Amazon S3 as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FNV0uocIqXftvNCPzFAMF%2FAmazon%20s3.png?alt=media&#x26;token=f674a63a-4594-4f9b-b02a-1a2a33bda4ee" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Amazon user account.
* **Access Key ID**: Your AWS Access Key ID. If not provided, Halyard/Spinnaker will try to find AWS credentials as described in [Using the Default Credential Provider Chain](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default)
* **Secret Access Key**: Your AWS user Secret Key
* **Region:** AWS region where the AWS S3 bucket is located.&#x20;
* **API Endpoint:** AWS S3 API Endpoint
* **API Region:** AWS S3 API region
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true&#x20;
* **Connect to CD**: Enable the selection & Select the spinnaker instance you want to associate this account to&#x20;
* **Group and Permissions**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### Artifactory

The following figure depicts the information to be provided to add Artifactory as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FLgP1yKs5SoVnJttU7Rz1%2FArtifactory.png?alt=media&#x26;token=da300d12-571a-4f00-bafa-d48a12755ad4" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Artifactory user account&#x20;
* **Endpoint**: The base URL through which your Artifactory search is reachable
* **Repo**: The repo to be searched in your Artifactory&#x20;
* **Repo Type**: The package type of repo to be searched in your Artifactory
* **Group ID**: The group id to be searched in your Artifactory&#x20;
* **Authentication Type**: Select the user authentication mode for Artifactory
* **User Name**: Provide Artifactory user name
* **Token / Password**: Provide Artifactory token or password, based on the authentication type selected
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the spinnaker instance you want to associate this account to&#x20;
* **Group and Permissions**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### **Bitbucket Cloud**&#x20;

The following figure depicts the information to be provided to add **Bitbucket Cloud** as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FFQ7vZ6ll4frBnf63En5l%2FBitbucket%20cloud.png?alt=media&#x26;token=dfd62582-febd-4e56-8326-5a22c87a0f9b" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Bitbucket user account
* **Host URL**: The base URL through which your Bitbucket search is reachable
* **API URL**: Your organizations unique API URL
* **Authentication Type**: Select Anonymous/Role-Based (No authentication required) as no authentication is required for bitbucket cloud
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the spinnaker instance you want to associate this account to&#x20;
* **Group and Permissions**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### **Bitbucket Server**&#x20;

The following figure depicts the information to be provided to add Bitbucket Server as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FyPxUxNXO4Atnlko3Gwrp%2FBitbucket%20server.png?alt=media&#x26;token=feb1b5cf-8196-4917-b3c3-668e1939f2b0" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Bitbucket user account&#x20;
* **Host URL**: The base URL through which your Bitbucket search is reachable
* **Authentication Type**: Select the user authentication mode for Bitbucket
* **User Name**: Provide Bitbucket user name
* **Token / Password**: Provide Bitbucket token or password depending on the authentication type selected
* **Group and Permissions**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### **Docker Registry**&#x20;

The following figure depicts the information to be provided to add Docker Registry as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FzJGaVJ7ULPh7gXmKTNUJ%2FDockerRegistry.png?alt=media&#x26;token=829936fd-17c4-4e6b-822c-414fe0df383a" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Docker Registry user account&#x20;
* **Registry URL**: Your Docker Registry url&#x20;
* **Email**: Provide the email ID of the Atlassian user
* **Repositories**: List of repositories to cache images
* **Group Membership**: Details of the group members
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the spinnaker instance you want to associate this account to&#x20;
* **Group and Permissions**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### **ECR**&#x20;

The following figure depicts the information to be provided to add ECR as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FnzquEBnRtaCkxdA7rgwk%2FECR.png?alt=media&#x26;token=0be3f52a-6e92-49a3-9dea-7a5f078879ac" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your ECR user account
* **Registry URL**: Registry URL for the ECR instance you are connecting to
* **Repositories** : List of repositories to cache images
* **Email** : Provide the email ID of the Atlassian user
* **Group Membership** : Details of the group members
* **Authentication Type**: Select the type of authentication mechanism you want to use to get authenticated to ECR server
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### GCR

The following figure depicts the details to be provided to add GCR as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2Fs3c6VdPU2zXQeqyo4yab%2FGCR.png?alt=media&#x26;token=9b7ab49c-6ac9-4e5e-bec1-1981c6f5be05" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Nam**e: The name of your GCR user account&#x20;
* **Registry URL**: Registry URL for the GCR instance you are connecting to
* **Repositories**: List of repositories to cache images
* **Email**: Provide the email ID of the Atlassian user
* **Group Membership**:&#x20;
* **Authentication Type**: Select the type of authentication mechanism you want to use to get authenticated to GCR server
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### GCS

The following figure depicts the details to be provided to add GCS as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2Fei3vXplVqxuRF0qgdWyL%2FGCS.png?alt=media&#x26;token=9210e67a-8b11-42be-9407-194c7104e843" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your GCS user account
* **Authentication Type**: Select the type of authentication mechanism you want to use to get authenticated to ECR server
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & Select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### Generic Docker Registries (ACR, Quay, JFrog)

The following figure depicts the details to be provided to add Generic Docker Registries as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FiE48II2bfX9TRjHP0gtE%2FGeneric%20docker.png?alt=media&#x26;token=7ced9de2-c318-4c57-9b79-92ec2689a0b1" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Generic Docker Registry user account
* **Registry URL**: Your Docker Registry URL
* **Email**: Provide the email ID of the Atlassian user
* **Repositories**: The repo in your Artifactory to be searched
* **Group Membership**:&#x20;
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### GitRepo

The following figure depicts the details to be provided to add GitRepo as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FCN3fBXJqvd6tfiHhOSlM%2FGitrepo.png?alt=media&#x26;token=b444a263-f21a-4fdb-ba95-60d44970fccb" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your GitRepo user account
* **API URL**: Your API URL
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**. <br>

### GitHub

The following figure depicts the details to be provided to add GitHub as an integration.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcoGehwRt8AXO0UZy-j-9O-FvR49idPWooVMMd4DfIiB9NTWiTMeRN3MyBsoL46wGVFujggjNcwALg0Xq0T3lAz9KftH2df00x7dafhWfvEQvkJYYWr0cxWug5-Wt9h1JwOglCuEHlTNx3S2MG0eNM1eKFl?key=F3hJERivfcrh9RxpOTb2ag" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your GitHub user account
* **Host URL**: Your Host URL
* **API URL**: Your API URL
* **Authentication Type:** Select the authentication type. Token based and SSH Authentication both are supported.&#x20;
  * For token based, enter the values for:
    * **User Name -** Name of the user.
    * **Token** - Enter the user token details
  * For SSH Authentication, enter the values for:&#x20;
    * **File Path** - Specify the location of the SSH key file.
    * **Pass Phrase** - Provide the pass phrase (password) to decrypt the SSH key if it is encrypted.&#x20;
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### GitLab

The following figure depicts the details to be provided to add GitLab as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FRQAfObLujpOochRdJyUO%2FGitlab.png?alt=media&#x26;token=5f8e10e1-4f3b-4450-a3cc-7d7d763ced30" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your GitLab user account
* **Host URL**: Your Host URL
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### Helm

The following figure depicts the details to be provided to add GitLab as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2Fgd0zxUolIOcs42l10yn8%2Fhelm.png?alt=media&#x26;token=3e471b4a-5bc3-434a-972e-92b9e8bcf3e3" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Helm user account&#x20;
* **Repository**: List of repositories to cache images
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

### Http

The following figure depicts the details to be provided to add GitLab as an integration.

<figure><img src="https://2047464521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBEa1hoX6SqpDj-ymNs%2Fuploads%2FnOXnYb0cKaLAum6CCsi2%2FHttp.png?alt=media&#x26;token=d5d7cf82-6b57-4cd3-beb3-51661fcfeed9" alt=""><figcaption></figcaption></figure>

Enter the information for the following fields:

* **Account Name**: The name of your Http user account
* **Authentication Type**: Select the user authentication mode for Docker Registry
* **Validate**: To validate the entries before saving, enable the Validate radio button. The default value is true
* **Connect to CD**: Enable the selection & select the CD instance you want to associate this account to
* **Group and Permission**: To enable access to all user groups, check the  **Enable all access to all the groups for this** checkbox. To provide access to only selected user groups, uncheck this checkbox and select the required users from the **Select Group** drop down and enable the needed permissions like **Edit**, **View** or **Delete**.&#x20;

<br>