[LTP] [PATCH v2 1/1] ci: Add hook to mirror docparse to homepage
Petr Vorel
pvorel@suse.cz
Fri Dec 9 15:10:02 CET 2022
GitHub Actions git push hook generates metadata HTML and push it
to LTP homepage.
Hook pushes only if there are actual changes in generated doc.
NOTE: this change requires to add:
1) Personal Access Token (PAT) to any developer which has write access
to homepage git repository [3]. In Developer settings -> Personal access
tokens -> Tokens (classic) [4]), where set:
Note: GH_PERSONAL_ACCESS_TOKEN
Select scopes: public_repo (minimal permission)
Expiration: either never or regularly renew.
2) Allow PAT in LTP organisation (I dared to already set it)
Iin linux-test-project group -> Settings -> Third-party Access -> Personal
access tokens -> Settings [5]
select:
Allow access via personal access tokens (classic)
API and Git access will be allowed using an organization member's personal access token (classic)
3) Add repository action secret to ltp repository
IN Settings -> Actions -> New repository secret [6]:
name: GH_PERSONAL_ACCESS_TOKEN
value: the value of previously created token.
Because using token, default permission is just read.
Reviewed-by: Aleks L <aleksandrosansan@gmail.com>
Signed-off-by: Petr Vorel <pvorel@suse.cz>
---
Changes v1->v2:
* permission write => read (the real permission is done with token)
* remove unused env
Testing:
https://github.com/foo-pevik/ltp_foo/actions/runs/3656966820
https://github.com/foo-pevik/linux-test-project.github.com_foo/commit/785150ba13a9934d6ce7325abecd05e3643a00ed
No generation with irrelevant change:
https://github.com/foo-pevik/ltp_foo/actions/runs/3656968653
.github/workflows/metadata-mirror.yml | 139 ++++++++++++++++++++++++++
1 file changed, 139 insertions(+)
create mode 100644 .github/workflows/metadata-mirror.yml
diff --git a/.github/workflows/metadata-mirror.yml b/.github/workflows/metadata-mirror.yml
new file mode 100644
index 000000000..296b3286c
--- /dev/null
+++ b/.github/workflows/metadata-mirror.yml
@@ -0,0 +1,139 @@
+# SPDX-License-Identifier: GPL-2.0-or-later
+# Copyright (c) 2022 Petr Vorel <pvorel@suse.cz>
+
+name: "Mirror metadata doc to homepage"
+
+on:
+ push:
+ branches:
+ - master
+
+permissions: {}
+jobs:
+ metadata-mirror:
+ permissions:
+ contents: read
+
+ runs-on: ubuntu-latest
+ if: ${{ github.repository == 'linux-test-project/ltp' }}
+ steps:
+ - name: Check secret
+ env:
+ GH_PERSONAL_ACCESS_TOKEN: ${{ secrets.GH_PERSONAL_ACCESS_TOKEN }}
+ run: |
+ if [ -z "$GH_PERSONAL_ACCESS_TOKEN" ]; then
+ echo "::error::GH_PERSONAL_ACCESS_TOKEN environment variable is not set"
+ exit 1
+ fi
+
+ - name: Checkout LTP
+ uses: actions/checkout@v3
+ with:
+ path: ltp
+ # we need to fetch whole history to get 'git describe' working for correct version in docs
+ fetch-depth: 0
+
+ - name: Checkout LTP homepage
+ uses: actions/checkout@v3
+ with:
+ repository: "linux-test-project/linux-test-project.github.com"
+ path: linux-test-project.github.com
+ persist-credentials: false
+
+ - name: Check metadata need to be updated
+ run: |
+ cd "$GITHUB_WORKSPACE/ltp/testcases/"
+
+ # check for changes
+ cd "$GITHUB_WORKSPACE/linux-test-project.github.com"
+ git grep '<p><strong>Version</strong>:' metadata/metadata.nightly.html
+ sed -ne 's/.*<p><strong>Version<\/strong>: \(.*\)<\/p>/\1/p' metadata/metadata.nightly.html
+ old_commit=$(sed -ne 's/.*<p><strong>Version<\/strong>: \(.*\)<\/p>/\1/p' metadata/metadata.nightly.html)
+ old_commit=$(echo "$old_commit" | sed 's/.*-g\(.*\)/\1/')
+ echo "::notice::old commit in linux-test-project.github.com: '$old_commit'"
+
+ echo "git log $old_commit..HEAD testcases/ | wc -l"
+ git log $old_commit..HEAD testcases/ | wc -l
+
+ echo "git log $old_commit..HEAD testcases/ 2>&1 | wc -l"
+ git log $old_commit..HEAD testcases/ 2>&1 | wc -l
+
+ if [ "$(git log $old_commit..HEAD testcases/ 2>&1 | wc -l)" = 0 ]; then
+ echo "::notice::no file changes in testcases/ directory since '$old_commit' => exit without commit and push"
+ exit 0
+ fi
+
+ - name: Install dependencies
+ run: |
+ apt="apt install -y --no-install-recommends"
+ sudo $apt asciidoctor autoconf automake libjson-perl libwww-perl make
+
+ echo "which asciidoctor"
+ which asciidoctor || { echo "::error::missing asciidoctor"; exit 1; }
+
+ - name: Configure LTP
+ run: |
+ cd "$GITHUB_WORKSPACE/ltp/"
+ make autotools && ./configure --with-metadata-generator=asciidoctor && make Version || { echo "::error::LTP configure failed"; exit 1; }
+
+ - name: Generate html metadata doc
+ run: |
+ cd "$GITHUB_WORKSPACE/ltp/metadata/"
+ echo "going to generate metadata"
+ make -j$(nproc)
+
+ - name: Check possible LTP homepage update
+ run: |
+ cd "$GITHUB_WORKSPACE/ltp/"
+ ltp_commit=$(git log --pretty=format:"%h" -1 .)
+ echo "::notice::Search for $ltp_commit in metadata/metadata.nightly.html"
+
+ cd "$GITHUB_WORKSPACE/linux-test-project.github.com"
+ grep "<p><strong>Version</strong>:" metadata/metadata.nightly.html
+ git pull
+ grep "<p><strong>Version</strong>:" metadata/metadata.nightly.html
+ if grep "<p><strong>Version</strong>: .*${ltp_commit}.*</p>" metadata/metadata.nightly.html; then
+ echo "::notice::$ltp_commit already in metadata/metadata.nightly.html => exit without commit and push"
+ exit 0
+ fi
+
+ - name: Push generated html metadata to LTP homepage
+ env:
+ GH_PERSONAL_ACCESS_TOKEN: ${{ secrets.GH_PERSONAL_ACCESS_TOKEN }}
+ run: |
+ git config --global user.email "actions@github.com"
+ git config --global user.name "Metadata doc mirror"
+
+ cd "$GITHUB_WORKSPACE/ltp/"
+ commit=$(git log --pretty=format:"%h" -1 .)
+ commit_desc=$(git log --pretty=format:"%h (\"%s\")" -1 .)
+ echo "commit_desc: '$commit_desc'"
+
+ cd "$GITHUB_WORKSPACE/linux-test-project.github.com"
+
+ # pull in case previous hook pushed later than checkout here had started
+ git pull
+
+ cp -v "$GITHUB_WORKSPACE/ltp/docparse/metadata.html" metadata/metadata.nightly.html
+
+ # skip if there is only different version and time
+ echo "Check for changes"
+ if ! git diff --unified=0 --no-color | grep -Po '(?<=^\+)(?!\+\+).*' | grep -v -e '^<p><strong>Version</strong>:' -e '^Last updated'; then
+ echo "::notice::No changes in metadata/metadata.nightly.html => exit without commit and push"
+ exit 0
+ fi
+
+ git add .
+
+ # only commit if there are changes
+ if git diff-index --quiet HEAD --; then
+ echo "::notice::No files changed in $GITHUB_WORKSPACE/linux-test-project.github.com => exit without commit and push"
+ git status
+ exit 0
+ fi
+
+ printf "metadata.nightly.html: Update to $commit\n\nUpdate metadata.nightly.html to $commit_desc\n" > /tmp/msg
+ git commit -F /tmp/msg .
+
+ echo "::notice::GH_PERSONAL_ACCESS_TOKEN: $GH_PERSONAL_ACCESS_TOKEN"
+ git push https://${GH_PERSONAL_ACCESS_TOKEN}@github.com/linux-test-project/linux-test-project.github.com.git
--
2.38.1
More information about the ltp
mailing list