Editing a Repository

Find out how to edit a repository in Container Registry.

Having created a repository in Container Registry, you can edit some of its properties. For example, for a standard repository, you might want to change access from private access to public access. For a pull-through cache repository, you can update the upstream username and upstream secret ID.

Your permissions control the repositories in Container Registry that you can edit (see Policies to Control Repository Access). You can edit repositories you've created, and repositories that the groups to which you belong have been granted access by identity policies. If you belong to the Administrators group, you can edit any repository in the tenancy.

    1. On the Container Registry list page, select the repository that you want to work with. If you need help finding the list page or the repository, see Listing Repositories.
      The repository's details page opens.
    2. Update the settings as needed. Avoid entering confidential information. For descriptions of the settings, see Creating a Repository.

      You cannot change the repository type, the upstream URL of a pull-through cache repository, or whether the top-level capability is enabled after the repository has been created.

      For example:

      • Select the Details tab and make the following edits:
        • For a standard repository, select the Edit button beside Access to change access to the repository (either Private or Public).
        • For a pull-through cache repository, select the Edit button beside Upstream username or Upstream secret ID to update the corresponding upstream authentication setting.
        • From the Actions menu, select Add scanner or Remove scanner to enable image scanning by adding an image scanner to the repository, or to disable image scanning (see Scanning Images for Vulnerabilities).

        • From the Actions menu, select Move resource to move the repository from one compartment to another (see Moving a Repository Between Compartments).

      • Select the Readme tab to view and edit the readme containing information about the repository.

      • Select the Image versions tab to view information about different image versions in the repository, delete image versions, and manage tags applied to image versions.

      • Select the Tags tab, to apply additional free-form tags and defined tags to the repository, or to modify or remove existing tags. To apply a defined tag, you must have permissions to use the tag namespace. For more information, see Applying Free-form Tags and Defined Tags to Repositories, Images, and Image Signatures.

  • Use the oci artifacts container repository update command and required parameters to edit repository properties:

    oci artifacts container repository update --repository-id <repository-ocid> [OPTIONS]

    For example:

    oci artifacts container repository update --repository-id ocid1.containerrepo.oc1.us-phoenix-1.0.ansh81vru1zp.aaaaaaaaswec83o... --is-public yes

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the UpdateContainerRepository operation to edit a repository.