Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tools: finalize automation/CI workflows #34

Merged
merged 3 commits into from
Jul 24, 2023
Merged

tools: finalize automation/CI workflows #34

merged 3 commits into from
Jul 24, 2023

Conversation

nodiscc
Copy link
Member

@nodiscc nodiscc commented Jul 23, 2023

No description provided.

@nodiscc nodiscc added enhancement New feature or request tools Automation and maintenance tools labels Jul 23, 2023
@nodiscc nodiscc added this to the 1.0.0 milestone Jul 23, 2023
@nodiscc nodiscc self-assigned this Jul 23, 2023
@nodiscc nodiscc marked this pull request as draft July 23, 2023 00:33
@nodiscc nodiscc force-pushed the ci-final branch 4 times, most recently from 9ac82e5 to 9ea40a4 Compare July 24, 2023 11:03
@nodiscc nodiscc changed the title WIP finalize automation/CI workflows finalize automation/CI workflows Jul 24, 2023
@nodiscc nodiscc marked this pull request as ready for review July 24, 2023 11:03
@nodiscc nodiscc changed the title finalize automation/CI workflows tools: finalize automation/CI workflows Jul 24, 2023
@nodiscc nodiscc marked this pull request as draft July 24, 2023 11:10
@nodiscc nodiscc force-pushed the ci-final branch 7 times, most recently from 312fb84 to a257eaf Compare July 24, 2023 13:20
@nodiscc nodiscc temporarily deployed to production July 24, 2023 13:23 — with GitHub Actions Inactive
@nodiscc nodiscc temporarily deployed to production July 24, 2023 13:50 — with GitHub Actions Inactive
@nodiscc nodiscc temporarily deployed to production July 24, 2023 14:05 — with GitHub Actions Inactive
- build markdown/HTML versions, use separate makefile targets/hecat configuration files for each export format/push task
- add non-free.md generation step to markdown export hecat configuration file
- add makefile targets to push exports to https://github.com/awesome-selfhosted/awesome-selfhosted and https://github.com/nodiscc/awesome-selfhosted-html-preview
- install: install sphinx <7 directly using pip since it can't be installed from setup.py sphinx-doc/sphinx#11130
- pin sphinx to version <7, sphinx-design is not compatible with sphinx 7 executablebooks/sphinx-design#130
- add sphinx configuration file
- tools/makefile: monkeypatch furo theme to display build tools and license link in footer (furo/sphinx does not provide a way to customize this pradyunsg/furo#612)
- fix dependencies between makefile targets
- setup/document SSH deploy keys usage
- each repository requires a different deploy key, trying to add a deploy key to repo B, which has already been added to repo A results in error 'this key already exists'
- set git remote URL to use ssh URIs before push (required to use SSH deploy keys)
- when referencing an environment secret, environment: key must be defined explicitly for the step (https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#referencing-an-environment)
- use a single SSH key file/no ssh-agent, else git push will try to use the first registered key and fail with permission denied when trying to push to the HTML repository
- use variables to identify target repos
- use temporary repositories as push destination
@nodiscc nodiscc marked this pull request as ready for review July 24, 2023 14:13
@nodiscc nodiscc merged commit a6c2697 into master Jul 24, 2023
1 check passed
@nodiscc nodiscc temporarily deployed to production July 24, 2023 14:15 — with GitHub Actions Inactive
@nodiscc nodiscc deleted the ci-final branch July 24, 2023 14:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request tools Automation and maintenance tools
Development

Successfully merging this pull request may close these issues.

1 participant