From 0d317feae0b1658f199997b532c44d72451165ee Mon Sep 17 00:00:00 2001 From: James Tanner Date: Thu, 21 Sep 2023 12:08:24 -0400 Subject: [PATCH] More notes. No-Issue Signed-off-by: James Tanner --- docs/community/administration.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/community/administration.md b/docs/community/administration.md index 354649755b..126473c0a3 100644 --- a/docs/community/administration.md +++ b/docs/community/administration.md @@ -1,5 +1,35 @@ # Community Galaxy Administration + +## Creating a new v3 namespace + +V3 Namespaces can be created in one of two methods: API or WebUI. + +### WebUI + +1) Login as a superuser +2) Expand "Collections" in the left nav +3) Click on "Namespaces" in the left nav +4) Click the "Create" button in the middle of the top header. +5) Fill in an appropriate name. +6) Click "Create" to save. +7) In the summary page for the new namespace, click on the 3 dot hamburger icon on the top right. +8) Choose "Edit Namespace" from the menu. +9) Fill in the various details such as the company name, logo url, and description. +10) Click "Save" + +### API + +``` +$ curl -X POST \ + -H 'Authorization: token ' \ + -H 'Content-Type: appliction/json' \ + -d '{"name": "foobar", "groups": []}' \ + https://galaxy-dev.ansible.com/api/_ui/v1/namespaces/ +``` + +TBD: Setting namespace details via the API. + ## Setting namespace owners Social auth in galaxy_ng has been heavily customized per https://github.com/ansible/galaxy_ng/pull/1881 @@ -12,6 +42,8 @@ The legacy namespaces should have a foreign key relationship with a v3 namespace A user on galaxy should be able to import roles into their legacy namespace, and also upload collections to their provider namespace (or any v3 namespace they've been added to). As the user logs into galaxy, the backend should validate and create their legacy namespace and the provider/v3 namespace automatically. + + #### Validating and fixing a user via the django shell ```