Skip to main content

release create

Create a new release using a collection of application manifest files and/or one or more Helm charts.

Usage

replicated release create --yaml-dir YAML_DIR [flags]
replicated release create --chart HELM_CHART [flags]
note

Additional flags returned by --help that are not supported by Replicated are omitted from the table below.

FlagType (if applicable)Description
--yaml-dirpath

The local directory containing multiple YAML manifest files for a release. (Required)

note

If your release supports installations with Replicated KOTS, --yaml-dir is required. If your release supports installations with the Helm CLI only, either --yaml-dir or --chart can be used.

--chartstring

The path to the Helm chart for a release.(Required)

note

If your release supports installations with Replicated KOTS, --yaml-dir is required. If your release supports installations with the Helm CLI only, either --yaml-dir or --chart can be used.

--promotestringChannel name to promote this release to. Case sensitive.
--ensure-channelWhen used with --promote channel, creates the channel if it does not exist.
--lintLint a manifest directory prior to creation of the release. For more information, see Linter Rules.
--release-notesstringWhen used with --promote channel, creates the release notes in markdown.
--versionstring

When used with --promote channel, sets the version label for the release in this channel.

If semantic versioning is enabled on the channel, then the version label must be a valid semantic version number. See Semantic Versioning in About Releases.

-h, --helpHelp for the command.

Examples

--yaml-dir

replicated release create --yaml-dir ./manifests

• Reading manifests from ./manifests ✓
• Creating Release ✓
• SEQUENCE: 58

--chart

replicated release create --chart=my-chart-1.0.0.tgz

• Reading chart from my-chart-1.0.0.tgz ✓
• Creating Release ✓
• SEQUENCE: 58

--promote

replicated release create --yaml-dir manifests --promote Unstable

• Reading manifests from manifests ✓
• Creating Release ✓
• SEQUENCE: 59
• Promoting ✓
• Channel Unstable successfully set to release 59

--ensure-channel

replicated release create --yaml-dir ./manifests --promote my-new-channel --ensure-channel

• Reading manifests from manifests ✓
• Creating Release ✓
• SEQUENCE: 60
• Promoting ✓
• Channel my-new-channel successfully set to release 60

--release-notes

replicated release create --yaml-dir ./manifests --promote Unstable --ensure-channel --release-notes "CI Release"

• Reading manifests from manifests ✓
• Creating Release ✓
• SEQUENCE: 61
• Promoting ✓
• Channel Unstable successfully set to release 61

--version

replicated release create --yaml-dir ./manifests --promote Unstable --ensure-channel --release-notes "Beta Release" --version "1.2.3"

• Reading manifests from manifests ✓
• Creating Release ✓
• SEQUENCE: 62
• Promoting ✓
• Channel Unstable successfully set to release 62