Skip to content

Lifecycle

Users can additional repositories in a project in just a few clicks using the Console or using the RCTL CLI using a declarative, version controlled spec for high levels of automation.

Create Repository

  • Login to the Console and navigate to your Project
  • Click on Integrations and Select Repositories
  • Click on New Repository
  • Provide a "friendly name" and select "type" (Git or Helm)

Create New Repository

Configure Repository

Once a repository is created, it needs to be configured before it can be used.

  • Provide the Endpoint URL: Two (2) types of Helm chart repositories are allowed
    1. Traditional Helm Repository (https://) – A standard HTTP(S)-based repository that hosts Helm charts with an index.yaml file.
      • Example: https://charts.bitnami.com/bitnami
    2. OCI-Based Helm Repository (oci://) – A container registry-based repository that stores Helm charts in an OCI-compliant format, similar to container images.
      • Example: oci://c8n.io/demouser1/nginx

        Note: In this example, c8n.io is a domain associated with a container registry service that allows users to store and manage Helm charts in an OCI-compliant format. The URL specifies a Helm chart (nginx) stored under the demouser1 namespace in the c8n.io registry.

Both repository types can be used in workloads and catalogs. Users can select the repository created with these Helm charts (of any type), specify the chart name, and define the version to deploy applications in workloads. In catalogs, users can create a catalog by linking a Helm repository and selecting charts for reuse across multiple deployments.

Reachability

The Reachability setting determines how the repository can be accessed:

  • Internet: Select this option if the repository is publicly accessible over the internet

  • Private Network: Choose this option if the repository is within a private network and requires internal connectivity. For private repositories that are operating in private networks, behind a firewall, the use of an agent is required.

Agent Selection

CA Certificate

  • Optionally, if using a private CA, copy/paste the CA certificate of the repository endpoint

Credentials

Access credentials need to be provided so that the repository can be securely accessed by the Controller.

UserPass Credential

If the organization requires the use of Username and Password/Token,

  • Select "UserPassCredential" for Type
  • Enter a valid "Username" and "Password/Token"
  • Click "Save"

SSH Private Key

If the organization requires the use of a SSH key for access,

  • Select "SSHCredential" for Type
  • Copy/Paste the "sshPrivateKey" in PEM format
  • Click "Save"

Configure Repository

Tip

Agents will be listed in the drop down list only if they have already been created.

Share Repositories

The existing Repositories can be shared with All/Specific/None projects. This helps to use the configured repo to infuse to the new pipeline if required or change the required resources

Agents Status

Make the required selection to share the agent and click Save

Agents Status

Note: Users cannot edit/share/delete the repositories inherited from other projects

Validate Access

Once a repository has been configured, it is good hygiene to validate access to verify that there is no accidental misconfiguration.

  • Navigate to Integrations -> Repositories
  • Click on Validate for your repository

The Controller will use the configured information to test access to the repository and report back. An illustrative example for successful validation is shown below.

Validate Access

View/Update Repository

Existing repositories can be viewed and updated anytime.

  • Navigate to Integrations -> Repositories
  • Click on the repository you are interested in to view configuration details.
  • If necessary update details and Save.

Delete Repository

Existing repositories can be removed anytime. Note that this is a destruction action and cannot be undone.

  • Navigate to Integrations -> Repositories
  • Click on Delete, Confirm Yes when prompted