Artifact Registry (SAR) in Google Distributed Cloud (GDC) air-gapped appliance supports and manages the
GDC deployment. The GDC private Artifact Registry stores the system artifacts.
There are various formats for system artifacts, such as:

- Container images for GKE Enterprise, KubeVirt, and GDC managed services
- Operating system (OS) images
- Firmware formats
- Golden virtual machine (VM) templates
- Helm charts

Artifact Registry participates in various GDC system
operations such as installation, upgrades, and the lifecycle of resources,
in a secure and scalable way.

## Artifact distribution

Artifact distribution is the process of distributing artifacts between registries. Within the Artifact Registry system, there might be instances of Harbor registries that need to distribute artifacts between themselves. Use artifact distribution to perform the following actions:

- Distribute artifacts from a Harbor registry on the bootstrapper node to a Harbor registry on the org infrastructure cluster.
- Distribute service bundles from a Harbor registry on the org infrastructure cluster to a Harbor registry on the fleet admin cluster.
- Pull artifacts from the source registry to a local storage and push them to the destination registry.
- Deploy Kubernetes and Harbor using Failover registry. This registry stores the necessary container images for Kubernetes and Harbor and runs as a `systemd` service on org infrastructure nodes.

## Learn about system limits

Discover the capabilities and limits of SAR in GDC. SAR supports release artifacts for a set amount of time and has limits in place for storage capacity. Availability and uptime information about SAR is also available. For more information, see [Learn about system limits](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/sar-system-limits.md.txt).

## Modify system artifacts

Modify system artifacts in GDC to manage and refine your deployment. To modify system artifacts, you must upload new Docker container images to the bootstrap machine or to the org infrastructure clusters. You can then use `gdcloud artifacts` commands to perform actions like managing packages, building images, patching, and optimizing your deployment. For more information, see [Modify system artifacts](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/modify-system-artifacts.md.txt).

## Audit changes to artifacts

Audit logs track changes and operations performed on system artifacts within the org infrastructure cluster. Use Grafana to access and view these logs. For more information, see [Audit changes to system artifacts](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/audit-system-artifacts.md.txt).

## Push and pull artifacts

GDC automatically pulls the latest artifacts from Harbor. However, you might need to manually push or pull system artifacts in some cases, such as pushing updated artifacts to patch bugs or fix outages. For more information, see [Push and pull container images from a cluster](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/push-container-image.md.txt).

## Manage SAR during an upgrade

Expand the storage capacity of the SAR in GDC. This might be necessary during an upgrade if the registry runs out of space.
The process involves checking the current storage usage and increasing the storage allocation by patching the persistent volume claim. A restart of the Artifact Registry is required for the changes to take effect. For more information, see [Resize artifact registry](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/resize-artifact-registry-storage.md.txt).

GDC package validation uses a root certificate authority (CA) to validate release key certificates. You must upgrade this root CA if a release notice requires it, or if you see a warning message during a system upgrade. To upgrade the certificate, see [Upgrade package validation certificate](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/infrastructure/io-operations-30/upgrade-package-validation-cert.md.txt).