From 814acf63c61642a5e576e7ff14690b906d686cca Mon Sep 17 00:00:00 2001 From: lowlighter <22963968+lowlighter@users.noreply.github.com> Date: Tue, 31 May 2022 17:48:35 -0400 Subject: [PATCH] docs: notice about token permissions and usage (relates #1050, #1076) --- .../imgs/setup_workflow_permissions.dark.png | Bin 0 -> 27014 bytes .../imgs/setup_workflow_permissions.light.png | Bin 0 -> 27506 bytes .../partials/documentation/setup/action.md | 8 +- source/app/web/statics/app.js | 2 + source/plugins/core/README.md | 91 +++++++++++------- 5 files changed, 66 insertions(+), 35 deletions(-) create mode 100644 .github/readme/imgs/setup_workflow_permissions.dark.png create mode 100644 .github/readme/imgs/setup_workflow_permissions.light.png diff --git a/.github/readme/imgs/setup_workflow_permissions.dark.png b/.github/readme/imgs/setup_workflow_permissions.dark.png new file mode 100644 index 0000000000000000000000000000000000000000..3d8fcf91f8a9d23c962e7d5e5b29be68b58e8584 GIT binary patch literal 27014 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 F{{uePZN>lq literal 0 HcmV?d00001 diff --git a/.github/readme/imgs/setup_workflow_permissions.light.png b/.github/readme/imgs/setup_workflow_permissions.light.png new file mode 100644 index 0000000000000000000000000000000000000000..841a968c09b6357184921fa242546b5b0adff142 GIT binary patch literal 27506 zcmbrm2UJsS_dSUEB4R^9s!~*nQUwem9RZatLI^E@bO=RS=pdldK|0a}sey!&Pz*(+ zNv|Og5R~2m(g_5Zi+=C7X6E;wnKd(aEtXmFN$x#Q-Fu&X681vl*_Ded7bz$xt|&iO zd`Us^&k_a28SM*afp=z#`(lBAs9!(Vccq}X+I;$VrroK~f`S6ZsjMik<4GXa+oFxZ zAJ+}{hU(pArkt_P?MJiBSJ$r5Q@+i9tEwpHeg8I#>e-;@*&ps)04v=sS9JNH$~owj z{bsR8`Q3{*@858o;TIQ^yCe2Vn>y;++n=}DoT1Fruz zA)a;saJ_+3{(bS^CItGwZ%_bD9^8@ITr_tYUxFU4?)_ruN)xMput(S4aKwrYjql6! z&o_!?H~aqd^aH>{s6FbHaf)56&s|{Et~(57m$~Pm#O^rNAl-=FUGte+>s=o+pT?}r zC!0)K?$x(!`s|JR?A7n;zg}Ll!8h%9LQo&nB-h?jD)6^tOxCU-eR}=ZNa_|sz_$Yr zWh!2HTv9aD$_UK~dQpONTi@Wxl-eNdpx;@CsfWF3423J5M)~!#E&fW3Ov7>#sQQQ3 zUWAYX_d12?VyFeqvRcXA`}_50MI7YmcZ_o$dy>Cj)M8d|cJUZv!&%Eo@mY?4J3*}i z?ze*}jbIRZ?0tMz6n~NowqU2YoH3&*rO!Dv9U-WUY^<=1Fq-n2I+{a;j!r{`71E7Y zAlPufKSS}A6NcXss#Dxv{2V`o+7@r z!iis~SlhN%Vy2j`@{aBnHfn+Q)1QINFM$8p->&2}B6b2%Fp#`ggWeq&`lq|JJw`a{ zi|TQ@^)IPM)G1=ms;OrB_{Z;_3zLwZLyNizYz%BgcigOSgsa2T9SPgtn5{F8)_zzO zg={JuCq{TxXJ>Ty?FBf+?5*=P3K>_R^P%|C0KL}AryNVz;lj{TTf7s}cHb7H^vRZM#2{LS2SL({)NSs(zPD zgiUer^{V@YrChhX6Q}U*nX`GZkVr*cv(vUE8KJ%4Xb#fx3k<aPQJYwYd_DUy+7tTNJ|Tgzj#%TQBvANp1f8vJ(h*;J=XN6UUQ3*$QUc z63+w%`GGtEjK9o|HT}dYME?3EWUjO0Qr}WSP1H0Uur3d

EIUW0(rK?-tUJQ}>VxC1E$ds=k}@y43bF1F`r? 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 S2i@wStEnn$-9z8Cc>X_~h%7Jw literal 0 HcmV?d00001 diff --git a/.github/readme/partials/documentation/setup/action.md b/.github/readme/partials/documentation/setup/action.md index e504b732..ab9d1a02 100644 --- a/.github/readme/partials/documentation/setup/action.md +++ b/.github/readme/partials/documentation/setup/action.md @@ -16,6 +16,8 @@ Its `README.md` will be displayed on your user profile: ## 1️ Create a GitHub personal token +> 💡 A GitHub personal token is required since this action will fetch data that cannot be accessed through repository-scoped tokens (like [`${{ secrets.GITHUB_TOKEN }}` or `${{ github.token }}`](https://docs.github.com/en/actions/security-guides/automatic-token-authentication#about-the-github_token-secret)) such as users, organizations, issues, pull requests, comments, commits, activity, etc. + From the `Developer settings` of your account settings, select `Personal access tokens` to create a new token. No scopes are required, but additional one may be required depending on which features will be used. Each plugin documentation enumerates which scopes are required to make it work. @@ -65,17 +67,21 @@ on: jobs: github-metrics: runs-on: ubuntu-latest + permissions: + contents: write steps: - uses: lowlighter/metrics@latest with: token: ${{ secrets.METRICS_TOKEN }} ``` -Rendered metrics will be committed to repository on each run. +Default output action is to commit rendered metrics to target repository on each run. ![Action update example](/.github/readme/imgs/example_action_update.light.png#gh-light-mode-only) ![Action update example](/.github/readme/imgs/example_action_update.dark.png#gh-dark-mode-only) +Use [`output_action`](/source/plugins/core/README.md#-configuring-output-action) to change this behaviour to use either pull requests, gists or manually handle renders. + ### 3️.1️ Choosing between `@latest`, `@master`/`@main`, a fork or a pinned version There are several *metrics* versions that can be used in workflows: diff --git a/source/app/web/statics/app.js b/source/app/web/statics/app.js index 387b755d..54dfaa1a 100644 --- a/source/app/web/statics/app.js +++ b/source/app/web/statics/app.js @@ -214,6 +214,8 @@ `jobs:`, ` github-metrics:`, ` runs-on: ubuntu-latest`, + ` permissions:`, + ` contents: write`, ` steps:`, ` - uses: lowlighter/metrics@latest`, ` with:`, diff --git a/source/plugins/core/README.md b/source/plugins/core/README.md index bcd2b0e7..af012b52 100644 --- a/source/plugins/core/README.md +++ b/source/plugins/core/README.md @@ -231,6 +231,14 @@ It is possible to generate a self-contained HTML file containing `✨ Metrics in ## 🧶 Configuring output action +Before configuring output action, ensure that workflows permissions are properly set. +These can be changed either through repository settings in Actions tab: + +![Setting workflows permissions](/.github/readme/imgs/setup_workflow_permissions.light.png#gh-light-mode-only) +![Setting workflows permissions](/.github/readme/imgs/setup_workflow_permissions.dark.png#gh-dark-mode-only) + +Or more granulary [at job or workflow level](https://docs.github.com/en/actions/security-guides/automatic-token-authentication#permissions-for-the-github_token). + ### Using commits (default) Use `config_output: commit` to make the action directly push changes to `committer_branch` with a commit. @@ -240,11 +248,15 @@ A custom commit message can be used through `committer_message`. *Example: push output to metrics-renders branch rather than the default branch* ```yaml -- uses: lowlighter/metrics@latest - with: - output_action: commit - committer_branch: metrics-renders - committer_message: "chore: update metrics" +metrics: + permissions: + contents: write + steps: + - uses: lowlighter/metrics@latest + with: + output_action: commit + committer_branch: metrics-renders + committer_message: "chore: update metrics" ``` ### Using pull requests @@ -257,15 +269,20 @@ The last step should use either `pull-request-merge`, `pull-request-squash` or ` *Example: push two outputs using a merge pull request* ```yaml -- uses: lowlighter/metrics@latest - with: - filename: my-metrics-0.svg - output_action: pull-request +metrics: + permissions: + contents: write + pull-requests: write + steps: + - uses: lowlighter/metrics@latest + with: + filename: my-metrics-0.svg + output_action: pull-request -- uses: lowlighter/metrics@latest - with: - filename: my-metrics-1.svg - output_action: pull-request-merge + - uses: lowlighter/metrics@latest + with: + filename: my-metrics-1.svg + output_action: pull-request-merge ``` ### Using gists @@ -277,10 +294,12 @@ It is required to provide a gist id to `committer_gist` option to make it work. *Example: push output to a gist* ```yaml -- uses: lowlighter/metrics@latest - with: - output_action: gist - committer_gist: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +metrics: + steps: + - uses: lowlighter/metrics@latest + with: + output_action: gist + committer_gist: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ``` ### Manual handling @@ -290,25 +309,29 @@ They will be available under `/metrics_renders/{filename}` in the runner. *Example: generate outputs and manually push them* ```yaml -- name: Checkout repository - uses: actions/checkout@v2 - with: - fetch-depth: 0 +metrics: + permissions: + contents: write + steps: + - name: Checkout repository + uses: actions/checkout@v2 + with: + fetch-depth: 0 -- uses: lowlighter/metrics@latest - with: - output_action: none + - uses: lowlighter/metrics@latest + with: + output_action: none -- uses: lowlighter/metrics@latest - run: | - set +e - git checkout metrics-renders - git config user.name github-actions[bot] - git config user.email 41898282+github-actions[bot]@users.noreply.github.com - sudo mv /metrics_renders/* ./ - git add --all - git commit -m "chore: push metrics" - git push + - uses: lowlighter/metrics@latest + run: | + set +e + git checkout metrics-renders + git config user.name github-actions[bot] + git config user.email 41898282+github-actions[bot]@users.noreply.github.com + sudo mv /metrics_renders/* ./ + git add --all + git commit -m "chore: push metrics" + git push ``` ## ♻️ Retrying automatically failed rendering and output action