Chapter 2. Red Hat Quay repository overview
A repository provides a central location for storing a related set of container images. These images can be used to build applications along with their dependencies in a standardized format.
Repositories are organized by namespaces. Each namespace can have multiple repositories. For example, you might have a namespace for your personal projects, one for your company, or one for a specific team within your organization.
Private repositories provide control over the users that have access to your images by allowing you to define users or teams who can push to, or pull from, the repository, thereby enhancing the security of your registry.
2.1. Adjusting repository visibility by using the UI
You can adjust the visibility of a repository to make it either public of private by using the Red Hat Quay UI.
Procedure
- On the Red Hat Quay UI, click Repositories in the navigation pane.
- Click the name of a repository.
- Click Settings in the navigation pane.
- Click Repository visibility.
- Click Make private. The repository is made private, and only users on the permissions list can view and interact with it.
2.2. Adjusting repository visibility by using the API
The visibility of your repository can be set to private or public by using the POST /api/v1/repository/{repository}/changevisibility command.
Prerequisites
- You have Created an OAuth access token.
-
You have set
BROWSER_API_CALLS_XHR_ONLY: falsein yourconfig.yamlfile. - You have created a repository.
Procedure
You can change the visibility of your repository to public or private by specifying the desired option in the
visibilityschema. For example:$ curl -X POST \ -H "Authorization: Bearer GCczXwaZ5i21p8hOO09uZqjZSsTYGKteu5PC5UuA" \ -H "Content-Type: application/json" \ -d '{ "visibility": "private" }' \ "https://quay-server.example.com/api/v1/repository/my_namespace/test_repo_three/changevisibility"Example output
{"success": true}
