Skip to content

Configuring replications

A replication endpoint must exist before you create a replication rule. To create an endpoint, see Managing registries.

Config replication

Creating a Replication Rule

  1. Click “Replications“ in the “Administration” menu in the navigator.
  2. Click the “+ New Replication Rule” button.
    The following pop-up window appears.
  3. Provide a name and description for the replication rule.
  4. Select “Push-based” or “Pull-based” replication mode, depending on whether you want to replicate images to or from the remote registry.
  5. If the pull-based replication mode is selected, use the “Source Registry” drop-down menu to select from the configured replication endpoints.

    Source Registry

  6. If the push-based replication mode is selected, use the “Destination Registry” drop-down menu to select from the configured replication endpoints.

    Destination Registry

  7. For “Source resource filter”, identify the images to replicate.

    Source resource filter

    • Name: Replicate resources with a given name by entering an image name or fragment.
    • Tag: Replicate resources with a given tag by entering a tag name or fragment.
    • Label: Replicate resources with a given Label.
    • Resource: Replicate images, charts, or both.

    The name filter and tag filters support the following patterns

    Pattern Description
    * Matches any sequence of non-separator characters /.
    ** Matches any sequence of characters, including path separators /.
    ? Matches any single non-separator character /.
    {alt1,...} Matches a sequence of characters if one of the comma-separated alternatives matches.
  8. Enter the name of the namespace in which to replicate resources in the “Destination namespace” text box.


    If you do not enter a namespace, resources are placed in the same namespace as in the source registry.

  9. Use the “Trigger Mode” drop-down menu to select how and when to run the rule.

    Trigger Mode Description
    Manual Replicate the resources manually when needed. Note that Deletion operations are not replicated.
    Scheduled Replicate the resources periodically by defining a cron job. Note that Deletion operations are not replicated.
    Event based When a new resource is pushed to the project or an image is retagged, it is replicated to the remote registry immediately. If you select the “Delete remote resources when locally deleted”, if you delete an image, it is automatically deleted from the replication target.
    Note: You can filter images for replication based on the labels that are applied to the images. However, changing a label on an image does not trigger replication. Event-based replication is limited to pushing, retagging, and deleting images.
  10. Optionally, select the “Override” and checkbox.

  11. Click “Save” to create the replication rule.

To edit or delete a replication rule, select the replication rule and click “Edit” or “Delete”. Only rules which have no executions in progress can be edited deleted.

Running Replication manually

  1. Select the replication rule using the checkbox from the “Replications” tab.
  2. Click the “Replicate” button.
    A pop-up window appears to confirm the replication.
  3. Click “Replicate” in the confirm window.
    The resources to which the rule is applied start to replicate from the source registry to the destination immediately.
  4. Click the rule to see its execution status. Replication
  5. Click the ID of the execution to see the details of the replication and the task list. The count of "IN PROGRESS" status in the summary includes both Pending and In Progress tasks. Execution
  6. Optionally, click "STOP" to stop the replication.
  7. Click the log icon to see detailed information about the replication task.

Any questions left?

Ask the community

Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.

Last update: April 1, 2022