From b29a6464e1b1a94bf74de9c40ee8169216543461 Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Aug 21 2025 15:20:32 +0000 Subject: [PATCH 1/6] Add how to set Pagure token in fedpkg Also clarify what ACLs are needed. Especially the request-repo and request-branch are tricky, as they require Create a ticket ACLs. --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index f16bfc0..63b9c05 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -33,6 +33,28 @@ you need to configure your account to be a member of the `mock` group: $ sudo usermod -a -G mock ---- +[#pagure-api-key] +=== Pagure API key + +Some fedpkg commands need to communicate with the Pagure API. First you +need to obtain a token from https://pagure.io/settings/token/new[Pagure.io]. + +To choose the correct ACLs, refer to this table of commands and ACLs they require: +[cols=",,"] +|=== +|Command|ACL + +|`disable-monitoring`|Modify an existing project +|`fork`|Fork a project +|`request-branch`|Create a ticket +|`request-repo`|Create a ticket + +Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): + +---- +$ fedpkg set-pagure-token +---- + [#kerberos_ticket] == Acquiring a Kerberos ticket From 7f39ae6820e00597b3b2241fd13b940317b831b4 Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Aug 21 2025 17:07:26 +0000 Subject: [PATCH 2/6] Fix ACL name for adding a ticket --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index 63b9c05..96824ec 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -36,7 +36,7 @@ $ sudo usermod -a -G mock [#pagure-api-key] === Pagure API key -Some fedpkg commands need to communicate with the Pagure API. First you +Some fedpkg commands need to communicate with the Pagure API. First you need to obtain a token from https://pagure.io/settings/token/new[Pagure.io]. To choose the correct ACLs, refer to this table of commands and ACLs they require: @@ -46,8 +46,8 @@ To choose the correct ACLs, refer to this table of commands and ACLs they requir |`disable-monitoring`|Modify an existing project |`fork`|Fork a project -|`request-branch`|Create a ticket -|`request-repo`|Create a ticket +|`request-branch`|Create a new ticket +|`request-repo`|Create a new ticket Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): From b9484a4edcc80dd94ed5b9ccbe4bcadc0619b3bb Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Aug 21 2025 17:22:51 +0000 Subject: [PATCH 3/6] Add request-test-repo command --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index 96824ec..206bfee 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -48,6 +48,7 @@ To choose the correct ACLs, refer to this table of commands and ACLs they requir |`fork`|Fork a project |`request-branch`|Create a new ticket |`request-repo`|Create a new ticket +|`request-test-repo`|Create a new ticket Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): From 7759574c99afdb152bffa57849a4b266b2eeb99f Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Aug 21 2025 17:23:00 +0000 Subject: [PATCH 4/6] Fix broken table --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index 206bfee..d1dc2d7 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -40,7 +40,7 @@ Some fedpkg commands need to communicate with the Pagure API. First you need to obtain a token from https://pagure.io/settings/token/new[Pagure.io]. To choose the correct ACLs, refer to this table of commands and ACLs they require: -[cols=",,"] +[cols=","] |=== |Command|ACL @@ -49,6 +49,7 @@ To choose the correct ACLs, refer to this table of commands and ACLs they requir |`request-branch`|Create a new ticket |`request-repo`|Create a new ticket |`request-test-repo`|Create a new ticket +|=== Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): From 3204633f639dc90820f12adc596e611ed9ac6cf7 Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Nov 19 2025 14:39:46 +0000 Subject: [PATCH 5/6] Add request-unretirement and switch the table around --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index d1dc2d7..23514fc 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -42,13 +42,11 @@ need to obtain a token from https://pagure.io/settings/token/new[Pagure.io]. To choose the correct ACLs, refer to this table of commands and ACLs they require: [cols=","] |=== -|Command|ACL +|ACL|Command -|`disable-monitoring`|Modify an existing project -|`fork`|Fork a project -|`request-branch`|Create a new ticket -|`request-repo`|Create a new ticket -|`request-test-repo`|Create a new ticket +|Modify an existing project|`disable-monitoring` +|Fork a project|`fork` +|Create a new ticket|`request-branch`,`request-repo`,`request-test-repo`,`request-unretirement` |=== Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): From 7b4dcb39b862880a01e0837d92c5dca492f68d1f Mon Sep 17 00:00:00 2001 From: Michal Pospíšil Date: Nov 19 2025 15:10:28 +0000 Subject: [PATCH 6/6] Improve wording and make the table more readable --- diff --git a/modules/ROOT/pages/Installing_Packager_Tools.adoc b/modules/ROOT/pages/Installing_Packager_Tools.adoc index 23514fc..40925b1 100644 --- a/modules/ROOT/pages/Installing_Packager_Tools.adoc +++ b/modules/ROOT/pages/Installing_Packager_Tools.adoc @@ -36,20 +36,32 @@ $ sudo usermod -a -G mock [#pagure-api-key] === Pagure API key -Some fedpkg commands need to communicate with the Pagure API. First you -need to obtain a token from https://pagure.io/settings/token/new[Pagure.io]. +Certain `fedpkg` commands need to communicate with the Pagure API. To use them, +you must first obtain a token from +https://pagure.io/settings/token/new[Pagure.io]. -To choose the correct ACLs, refer to this table of commands and ACLs they require: -[cols=","] +Refer to the table below to identify which ACL must be selected for specific +commands: +[cols=",",] |=== -|ACL|Command +|Command |Required ACL -|Modify an existing project|`disable-monitoring` -|Fork a project|`fork` -|Create a new ticket|`request-branch`,`request-repo`,`request-test-repo`,`request-unretirement` +|`disable-monitoring` +|Modify an existing project + +|`fork` +|Fork a project + +|`request-branch` +.4+.^|Create a new ticket + +|`request-repo` +|`request-test-repo` +|`request-unretirement` |=== -Save that token in the `fedpkg` configuration (this command is interactive, no arguments required): +Save that token in the `fedpkg` configuration (this command is interactive, no +arguments required): ---- $ fedpkg set-pagure-token