@@ -349,8 +349,15 @@ repository is public, then anyone can `pull` from the repository.
349349Distributions are Pulp resources that represent URLs where repositories can be consumed.
350350Permissions for accessing specific container repositories are described in terms of permissions
351351to access Container Distributions. Each time a new repository is pushed using ` podman ` or ` docker ` ,
352- a Container Distribution is created. There is also a Container Push Repository created. Both of
353- these resources can be accessed using Pulp's API.
352+ a Container Distribution and a Container Repository are created. Both resources can be accessed
353+ using Pulp's API. Registry-pushed repositories inherit distribution and namespace permissions for
354+ read and content-modifying API actions.
355+
356+ !!! note
357+
358+ Older versions of pulp-container created Container Push Repositories on docker pushes. Legacy
359+ pushes still remain available under `/pulp/api/v3/repositories/container/container-push/`, but
360+ will be migrated to Container Repositories in a future release.
354361
355362The creation of a new distribution creates three user groups that can access the distribution:
356363Owners, Collaborators, and Consumers. The user that creates the distribution is automatically added to
@@ -369,17 +376,10 @@ object permissions for the Distribution:
369376"container.change_containerdistribution"
370377```
371378
372- The Owners group also has the following permissions for the Container Push Repository associated
373- with the Distribution:
374-
375- ```
376- "container.view_containerpushrepository"
377- "container.modify_content_containerpushrepository"
378- ```
379-
380- The owners of a Container Distribution have the ability to update and delete the repository
381- associated with the Distribution. They can also add/remove users from the groups associated with
382- the distribution.
379+ Distribution roles grant access to the linked Container Repository through the distribution and
380+ namespace permission checks described above. Distribution owners can update and delete the
381+ repository associated with the distribution. They can also add/remove users from the roles
382+ associated with the distribution.
383383
384384#### Distribution Collaborators
385385
@@ -392,14 +392,6 @@ following object permissions for the Distribution:
392392"container.push_containerdistribution"
393393```
394394
395- The Collaborators group also has the following permissions for the Container Push Repository associated
396- with the Distribution:
397-
398- ```
399- "container.view_containerpushrepository"
400- "container.modify_content_containerpushrepository"
401- ```
402-
403395Users in the Collaborator group can do everything that the owners can, with the exception for deleting
404396the Distribution.
405397
@@ -413,14 +405,7 @@ object permissions for the distribution:
413405"container.pull_containerdistribution"
414406```
415407
416- The Consumers group also has the following permissions for the Container Push Repository associated
417- with the Distribution:
418-
419- ```
420- "container.view_containerpushrepository"
421- ```
422-
423- Users in the Consumers group can the ` pull ` the repository. Users should only need to be added to
408+ Users in the Consumers group can ` pull ` the repository. Users should only need to be added to
424409this group if the Distribution has been configured with ` private=True ` . If the Distribution is
425410public, then anyone can ` pull ` from the repository associated with the Distribution.
426411
@@ -484,8 +469,10 @@ permission on the Distribution:
484469```
485470
486471Users that wish to be able to access the repository associated with the distribution with Pulp's
487- API need the following object level permission on the Container Push Repository :
472+ API need one of the following :
488473
489474```
490- "container.view_containerpushrepository"
475+ "container.view_containerrepository" (object-level repository role), or
476+ "container.view_containerdistribution" (distribution consumer role or above), or
477+ "container.namespace_view_containerdistribution" (namespace consumer role or above)
491478```
0 commit comments