> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/artifact-registry/3.0/use-artifact-registry/platform-integrations/ci-ar-integrations.md).

# Artifact Registry and Continuous Integrations

Learn how to use Artifact Registry with the Continuous Integration (CI) module.

### Build and push to Docker with Artifact Registry <a href="#build-and-push-to-docker-with-artifact-registry" id="build-and-push-to-docker-with-artifact-registry"></a>

Harness CI offers a [Build and push to Docker](/continuous-integration/use-harness-ci/use-harness-ci/build-and-upload-artifacts/build-and-push/build-and-push-to-docker-registry.md) step that allows you to build and push a docker image to any registry. Usually, this requires a connector to the registry you want, but with AR you can connect to a registry directly, within the platform, without any complicated setup.

{% tabs %}
{% tab title="Interactive guide" %}
{% embed url="<https://app.tango.us/app/embed/7892f010-0f5b-4acd-8ad3-9de5426ba386>" %}
Build and Push Docker Images with Harness Artifact Registry
{% endembed %}
{% endtab %}

{% tab title="Step-by-step" %}
To do so, follow these steps:

1. Navigate to your pipeline, and enter your `Build` stage.
2. Create a new `Build and Push an image to Docker Registry` step.
3. `Harness Artifact Registry` is the default registry type. Ensure that it is selected, and move to the next step.
4. Select your registry under `Registry`. Clicking the field will show a list of available registries.
5. Once your registry is selected, a list of images will populate under `Image Name`. Choose one, or type the name of a new image that you are building the first time.
6. Enter any image tags you wish under `Tags`.
7. Click `Apply Changes` at the top right, and you are done! No connectors needed.
   {% endtab %}
   {% endtabs %}

### Upload Artifacts to Harness Artifact Registry <a href="#upload-artifacts-to-harness-artifact-registry" id="upload-artifacts-to-harness-artifact-registry"></a>

Harness CI provides a native **Upload Artifacts to Harness Artifact Registry** step that simplifies the process of publishing artifacts directly to your Harness Artifact Registry. This dedicated step supports multiple package types and eliminates the need for complex scripting or external connectors.

The Upload Artifacts step allows you to configure artifact uploads through a simple interface. You can specify the package type, target registry, and source path for your artifacts. The source path typically points to artifacts generated from a previous step in your pipeline, such as a Run step that builds, creates, or downloads packages.

{% hint style="info" %}
**SOURCE PATH CONFIGURATION**

Enter the **Source Path** where your artifact is located:

* This path typically references the output from a previous step, such as:
  * `/harness/target/*.jar` for Maven artifacts
  * `/harness/example.tar.gz` for npm tarballs
  * `/harness/build/` for Python wheels
* You can use expressions to reference outputs from earlier steps

**Package-specific requirements:**

* **Generic packages**: Requires explicit package name and version
* **Go packages**: Requires explicit version specification
  {% endhint %}

{% hint style="info" %}
The Upload Artifacts step uses Harness CLI internally to upload artifacts to Harness Artifact Registry, ensuring consistent behavior and authentication across all package types.
{% endhint %}

<details>

<summary>Example YAML</summary>

```yaml
pipeline:
  name: Upload Conda Package to Artifact Registry
  identifier: conda_upload_pipeline
  projectIdentifier: default_project
  orgIdentifier: default
  stages:
    - stage:
        name: Build and Upload
        identifier: build_upload_stage
        type: CI
        spec:
          cloneCodebase: true
          execution:
            steps:
              - step:
                  type: Run
                  name: Download Conda Package
                  identifier: download_conda_package
                  spec:
                    shell: Sh
                    command: |-
                      #!/bin/sh
                      set -e

                      # Configuration
                      PACKAGE_NAME="docutils-stubs"
                      CHANNEL="conda-forge"

                      echo "Fetching metadata for ${PACKAGE_NAME} from ${CHANNEL}"

                      # Fetch package metadata
                      JSON_DATA=$(curl -s "https://api.anaconda.org/package/${CHANNEL}/${PACKAGE_NAME}/files")

                      # Extract the first download URL
                      LATEST_URL=$(echo "${JSON_DATA}" \
                        | grep -o '"download_url": "[^"]*"' \
                        | head -n 1 \
                        | cut -d'"' -f4)

                      # Validate URL
                      if [ -z "${LATEST_URL}" ]; then
                        echo "Failed to retrieve download URL"
                        exit 1
                      fi

                      # Normalise protocol if required
                      case "${LATEST_URL}" in
                        //* ) LATEST_URL="https:${LATEST_URL}" ;;
                      esac

                      FILE_NAME=$(basename "${LATEST_URL}")

                      echo "Downloading ${FILE_NAME}"

                      # Download artifact
                      curl -L "${LATEST_URL}" -o "${FILE_NAME}"

                      # Resolve absolute path
                      FILE_PATH="$(pwd)/${FILE_NAME}"

                      echo "Resolved artifact path: ${FILE_PATH}"

                      # Write output using Harness supported contract
                      echo "FILE_PATH=${FILE_PATH}" >> "${DRONE_OUTPUT}"
              
              - step:
                  type: HarUpload
                  name: Upload to Artifact Registry
                  identifier: upload_to_registry
                  spec:
                    registryRef: my_conda_registry
                    packageType: CONDA
                    sourcePath: <+steps.download_conda_package.output.outputVariables.FILE_PATH>
          platform:
            os: Linux
            arch: Arm64
          runtime:
            type: Cloud
            spec: {}
```

</details>

**Key Points:**

1. **Step 1 (Run):** Downloads a Conda package from conda-forge and outputs the file path using `DRONE_OUTPUT`
2. **Step 2 (HarUpload):** References the output variable from Step 1 using `<+steps.download_conda_package.output.outputVariables.FILE_PATH>` and uploads to the specified registry
3. **Package Type:** Set to `CONDA` to ensure proper indexing in Artifact Registry
4. **Source Path:** Dynamically references the downloaded artifact location from the previous step

### Add a Run or Plugin Step to Your CI Pipeline <a href="#add-a-run-or-plugin-step-to-your-ci-pipeline" id="add-a-run-or-plugin-step-to-your-ci-pipeline"></a>

Seamlessly reference artifacts stored in Harness Artifact Registry within your CI Run and Plugin steps. This functionality eliminates the need for an external connector, providing a streamlined and user-friendly experience, while enabling efficient and simplified workflows.

{% tabs %}
{% tab title="Interactive guide" %}

{% endtab %}

{% tab title="Step-by-step" %}
To do so, follow these steps:

1. Navigate to your pipeline, and enter your `Build` stage.
2. Create a new `Run` step.
3. `Harness Artifact Registry` is the default registry type. Ensure that it is selected, and move to the next step.
4. Select your registry under `Registry`. Clicking the field will show a list of available registries.
5. Enter your artifact's `imageName:version`.
6. Add your run command, e.g. \`echo "Run step completed".
7. Click `Apply Changes`.

To verify the Run or Plugin step executes as expected, run the pipeline.
{% endtab %}
{% endtabs %}