Channels

Channels are locations in the repository that contain artifacts that have been mirrored, uploaded, copied, or moved. Subchannels (referred to as labels in anaconda.org) offer an additional level within your channel for fine-grained access to artifacts.

Both administrators and users can define channels and subchannels, determine which artifacts are available in a channel or subchannel, and restrict or grant access to specific users or groups.

When a user logs in to Anaconda Server for the first time, a user profile and default channel are created for them. Their default channel name is identical to their username. If the username is an email address, the portion before the @ will be used as the username. Because channel names are restricted to a limited set of characters, some characters in an email address will be replaced with an underscore.

​

Viewing channels you can access

The dashboard shows a list of channels that you have access to. If you have access to more than 10 channels, you can click Show all… at the bottom of the list to view all your channels. Private channels that you don’t have access to will not appear in this list.

Alternatively, you can open the user dropdown menu and select My Channels to get a list of channels that you own or have access to. If you are an administrator, you can also select All Channels to view a complete list of channels for your Anaconda Server.

​

Viewing channel details

Open a channel from the Dashboard or from the My Channels page to view its details.

Selecting the channel’s information icon displays additional information, such as the channel’s metadata, as well as a command for creating a mirror in this channel from an external source using the CLI. For more information about using the CLI, see Anaconda Server CLI.

​

Viewing subchannel details

To view a subchannel’s details:

1. Open a channel from the Dashboard or from the My Channels page.
2. Select the Subchannels tab.
3. Click on the name of the subchannel you want to view.

​

Creating a channel

To create a new channel in Anaconda Server:

1. From the Dashboard, My channels, or All channels pages, click Add Channel.

2. Enter a unique name for your channel.

3. Provide a brief description of the channel.

4. Set the privacy level for your channel.

5. Set the CVE notifications for your channel.

6. Set any mirroring filters for your channel.

7. Click Submit.

​

Creating a subchannel

To create a subchannel in Anaconda Server:

1. Open a channel from the Dashboard or from the My Channels page.

2. Open the Manage dropdown menu and select Add Subchannel.

3. Enter a unique name for your subchannel.

4. Provide a brief description of the subchannel.

5. Set the privacy level for your subchannel.

6. Set the CVE notifications for your subchannel.

7. Set any mirroring filters for your subchannel.

   Ensure that your subchannel package filters do not conflict with the channel’s package filters. Conflicting filters prevent packages from being mirrored correctly into your subchannel.

8. Click Submit.

​

Editing a channel

You can update the name, description, privacy level, and package filters of your channel at any time after creation. To edit a channel:

1. Navigate to the channel’s details page.
2. Open the Manage dropdown menu and select Edit.

​

Editing a subchannel

You can update the name, description, privacy level, and package filters of your subchannel at any time after creation. To edit a subchannel:

1. Navigate to the subchannel’s details page.
2. Open the Manage dropdown menu and select Edit.

​

Deleting a channel

To delete a channel in Anaconda Server:

1. Navigate to a channel’s details page.
2. Open the Manage dropdown menu and select Delete.

​

Deleting a subchannel

To delete a subchannel in Anaconda Server:

1. Navigate to the subchannel’s details page.
2. Open the Manage dropdown menu and select Delete.

You can also delete multiple subchannels at once:

1. Navigate to a channel’s details page.
2. Select the Subchannels tab.
3. Select the checkboxes next to the subchannels you want to delete.
4. Click Delete # subchannels.
5. Click Delete to verify you want to delete your selected subchannels.

​

Freezing a channel

Creating a mirror consumes a large amount of CPU resources. This is because, each time an artifact is added to the channel from the mirror, the channel index is rebuilt to add the artifact to the Packages tab of your channel. If you want to conserve or reduce your CPU usage, you can freeze your channel before creating a mirror to prevent the channel index from being rebuilt every time an artifact is registered from the mirror’s source.

To freeze a channel:

1. Navigate to the channel’s details page.
2. Open the Manage dropdown menu and select Freeze.
3. Click Freeze.

​

Unfreezing a channel

Once the mirror completes, unfreeze the channel to rebuild the channel index. To unfreeze a channel:

1. Navigate to the channel’s details page.
2. Open the Manage dropdown menu and select Unfreeze.
3. Click Unfreeze.

If you unfreeze your channel before your mirror completes, the indexing operations for artifacts registered while the channel was frozen will occur simultaneously, then the mirror will resume performing normal indexing operations for artifacts as they are registered from the mirror’s source until it completes.

When you freeze a channel, then run a mirror, the History tab will show the mirror starting, artifacts registering, and the mirror completing. Existing packages will not appear in the channel until it is unfrozen.

​

Channel change log

Sometimes, due to newly reported CVEs or an updated CVE score or status, the contents of your channel will change when the mirror performs its scheduled run. A package may become available that was not available previously, or you could discover that a package you’ve been using is removed from your channel entirely!

The channel change log shows a record of all package additions and removals within a channel, and provides a reason why the package was added or removed. Packages that are manually moved, copied, or deleted will also appear in the channel change log.

To view the channel change log:

1. Navigate to the channel’s details page.
2. Open the Manage dropdown menu and select Channel Changes.
3. Click Export to download an .xlsx file of your channel changes.

​

Running the blob cleanup tool

The blob cleanup tool removes artifacts associated with deleted channels to free disc space. If an artifact on a deleted channel exists in another channel, it will not be removed.

You can turn on and schedule the blob cleanup tool to run on its own by adding a few lines of code to the docker-compose.yml file.

1. Open a terminal.

2. Log in to the server that hosts your Anaconda Server installation. Speak with your system administrator if you need help with this step.

3. Open your anaconda installer directory by running the following command:

   Copy

   Ask AI

   # Replace <INSTALLER_DIR> with your installer directory
   cd <INSTALLER_DIR>
   

4. Open your docker-compose.yml file.

5. Find the repo_worker: section of the file and append the following lines:

   • REPO_ENABLE_CLEANUP_BLOBS_JOB=true
   • REPO_SCHEDULE_CLEANUP_BLOBS_CRON=0 0 1 * *

6. Save your additions and close the file.

7. Restart your instance for changes to take effect. To restart your instance, run the following commands:

   Copy

   Ask AI

   docker compose down
   docker compose up -d
   

The blob cleanup tool runs on a schedule determined by the cron expression in the second line of code you just added to your file. The expression 0 0 1 * * will run the tool on the first day of the month at midnight. To modify when this job runs:

1. Open your docker-compose.yml file.
2. Find the REPO_SCHEDULE_CLEANUP_BLOBS_CRON=<CRON_EXPRESSION> line and replace the <CRON_EXPRESSION> with a valid cron expression, then save it.
3. Restart your instance for changes to take effect.

You can also run the blob cleanup tool using the API at any time.

​

Rebuilding your channel index

The channel index is automatically rebuilt when certain actions, such as adding or deleting a package, are made. However, if you need to manually rebuild your channel’s index for any reason, follow these steps:

1. Navigate to the channel’s details page.
2. Open the Manage dropdown menu and select Rebuild Index.

​

Setting your default channel

If your permissions allow, you can update your default channel at any time. To update your default channel:

1. Open the user dropdown menu and select Settings.

2. Update the current entry in the Default Channel field.

3. Click Save.

​

Managing channels with the CLI

If you want to create and manage your channels using the CLI, see Anaconda Server CLI

​

Managing channels with the API

You can also use the API to perform various functions for channels and subchannels. Access the API interface by opening a browser and navigating to http(s)://<FQDN>/swagger/ui, replacing <FQDN> with your Anaconda Server fully qualified domain name.

The following is a list of available endpoints you can use to manage your channels in Anaconda Server.

​

Viewing channels you can access

GET /api/channels/
GET /api/account/channels

​

Creating a channel

POST /api/channels

​

Creating a subchannel

POST /api/channels/<CHANNEL_NAME>/subchannels

​

Viewing channel details

GET /api/channels/<CHANNEL_NAME>
GET /api/channels/<CHANNEL_NAME>/artifacts
GET /api/channels/<CHANNEL_NAME>/history
GET /api/channels/<CHANNEL_NAME>/mirrors
GET /api/channels/<CHANNEL_NAME>/subchannels

​

Viewing subchannel details

GET /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>
GET /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>/artifacts
GET /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>/history
GET /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>/mirrors

​

Editing a channel

PUT /api/channels/<CHANNEL_NAME>

​

Editing a subchannel

PUT /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>

​

Deleting a channel

DELETE /api/channels/<CHANNEL_NAME>

​

Deleting a subchannel

DELETE /api/channels/<CHANNEL_NAME>/subchannels/<SUBCHANNEL_NAME>

​

Running the blob cleanup tool

DELETE /api/system/blob_cleanup
POST /api/system/blob_cleanup
POST /api/diagnose/blobs