Skip to main content

Creating and Editing Channels

There are three default channels that can be edited or archived. You can also add custom channels.

The default channels are:

  • Stable: The Stable channel is intended for production installations.
  • Unstable: The Unstable channel is intended for internal testing.
  • Beta: The Beta channel is intended for release candidates and early adopting customers.

For more information, see About channels.

Create a Channel​

To create a channel:

  1. From the Replicated vendor portal, select Channels from the left menu.

  2. Click Create Channel.

    The Create a new channel dialog opens.

    Create Channel

  3. Enter a name and description for the channel.

  4. (Optional) To enable semantic versioning on the channel, if it is not enabled by default, turn on Enable semantic versioning. If you enable semantic versioning for a channel and then promote releases to it, Replicated recommends that you do not later disable semantic versioning for that channel. For more information about semantic versioning and defaults, see Semantic Versioning.

  5. (Optional) To enable an air gap bundle format that supports image digests and deduplication of image layers, turn on Enable new air gap bundle format. For more information, see Using Image Tags and Digests in Connecting to an Image Registry.

  6. Click Create Channel.

Edit a Channel​

To edit an existing channel:

  1. In the vendor portal, select Channels from the left menu.

  2. Click the gear icon on the top right of the channel that you want to modify.

    The Channel settings dialog opens.

  3. Edit the fields and click Save.

Enable Semantic Versioning using the CLI​

You can enable semantic versioning on the channel, if it is not enabled by default. If you enable semantic versioning for a channel and then promote releases to it, Replicated recommends that you do not later disable semantic versioning for that channel. For more information about semantic versioning and defaults, see Semantic Versioning.

Run the following command to enable semantic versioning on a channel: 

`replicated channel enable-semantic-versioning CHANNEL_ID`

Replace CHANNEL_ID with the ID of the target channel.

Archive a Channel​

You can archive an existing channel to prevent any new releases from being promoted to the channel.

note

You cannot archive a channel if:

  • There are customers assigned to the channel.
  • The channel is set as the default channel.

Assign customers to a different channel and set a different channel as the default before archiving.

To archive a channel with the vendor portal or the replicated CLI:

  • Vendor portal: In the vendor portal, go to the Channels page and click the trash can icon in the top right corner of the card for the channel that you want to archive.

  • replicated CLI:

    1. Run the following command to find the ID for the channel that you want to archive:

      replicated channel ls

      The output of this command includes the ID and name for each channel, as well as information about the latest release version on the channels.

    2. Run the following command to archive the channel:

      replicated channel rm CHANNEL_ID

      Replace CHANNEL_ID with the channel ID that you retrieved in the previous step.

      For more information, see channel delete in the replicated CLI documentation.

Next Steps​

Do one of the following:

How to Package and Distribute an Application