rancher-charts/README.md

2.4 KiB

Staging Branch

This branch contains generated assets that have not been officially released yet.

The following directory structure is expected:

assets/
  <package>/
    <chart>-<packageVersion>.tgz
  ...
charts/
  <package>
    <chart>
      <packageVersion>
        # Unarchived Helm chart
  ...

Configuration

This repository branch contains a configuration.yaml file that is used to specify how it interacts with other repository branches.

Sync

This branch syncs with the generated assets from the following branches:

To release a new version of a chart, please open the relevant PRs to one of these branches. Merging should trigger a sync workflow on pushing to these branches.

Validate

This branch validates against the generated assets of the following branches to make sure it isn't overriding already released charts.

Before submitting any PRs, a Github Workflow will check to see if your package doesn't break any already released packages in these repository branches.

Makefile

Package-Level (requires packages/ to exist)

make prepare: Pulls in your charts from upstream and creates a basic generated-changes/ directory with your dependencies from upstream

make patch: Updates your generated-changes/ to reflect the difference between upstream and the current working directory of your branch. Requires prepare

make charts: Runs prepare and then exports your charts to assets/ and charts/ and generates or updates your index.yaml. Can be used for testing; a Rancher Helm Repository that points to a branch that has these directories with the index.yaml should be able to find and deploy working copies of your chart.

make clean: Cleans up all the working directories of charts to get your repository ready for a PR

Branch-Level (requires either packages/ or assets/ + charts/)

make pull-scripts: Pulls in the version of the charts-build-scripts indicated in scripts

make validate: Validates your current repository branch against all the repository branches indicated in your configuration.yaml

make sync: Syncs the assets in your current repository with the merged contents of all of the repository branches indicated in your configuration.yaml

make update: Pulls in the latest docs, scripts, etc. from the charts-build-scripts repository