mirror of
https://github.com/docker-mailserver/docker-mailserver.git
synced 2024-01-19 02:48:50 +00:00
cf22475382
* docs(ci): Support deploy previews for documentation Each PR that contributes to docs will generate a unique (to that PR) URL to preview the PR live for review. * docs(ci): Split workflow To support previews from non-collaborators PR contributions, we cannot rely on secrets access from workflows triggered by the `pull_request` event. To do so securely, according to official advice from Github, we must run the third-party contribution in the restricted `pull_request` context, and then use a 2nd workflow to deploy the build (which requires secrets access). * docs(ci): Rename doc workflows + add commit status Better naming convention for documentation workflows. Split workflow only indicated status on PR of the 1st stage (building the preview to deploy), not the deployment progress/result. This needs to be managed more directly until the action better supports split-workflow scenario. * docs(ci): Add concurrency limit to preview deploy workflow This would be more ideal on the 2nd phase workflow (`workflow_run`), however keeping it simple for now. Limits the concurrency of the initial pull request workflow for documentation contributions that have PRs with multiple event triggers in a small time span (before the workflow triggered would complete). The main benefit is to avoid redundant deploys if the initial workflow has been triggered again to build the PR once more. It only will work against concurrent workflows for that PR in the 1st stage, if an existing `workflow_run` (2nd stage) is active for that PR it will not be cancelled. * docs(ci): Add sponsor branding for deploy preview service A requirement from Netlify for the [sponsored OSS organization plan](https://www.netlify.com/legal/open-source-policy). * docs(ci): Use a shared build script Production and Deploy Preview builds are now maintained via the same shell command, so version updates of docker image is in one place. Additionally deletes unnecessary build output which upstream provides no support to exclude. * docs: Add a custom 404 page This is used by the preview deploys on Netlify. Production deploys on Github Pages require a top-level 404 page manually deployed (since all are deployed to a version subpath). This 404 page was custom built and optimized by me. This is the final minified output, separate source to build is available if needed. --- Likewise the `favicon.ico` is a fallback for browsers that implicitly check the domain root for this file if the SVG isn't supported/preferred. Browsers check for this file without it being present in the HTML head meta elements. On Github Pages the `favicon.ico` isn't likely to be picked up by even top-level as typical deployment has the project name as a subpath. The docs however reference a PNG favicon which should be widely supported. The `favicon.ico` was generated by RealFaviconGenerator online tool with SVG source input. It contains 16px, 32px and 48px sizes. Quality is better than the `favicon.io` generator. * chore: Optimized logo SVG source cleaned up and optimized with SVGO 2.3. Minified versions (`.min.svg` extension) remove unnecessary data and white-space to reduce size further for production use. This extension better differentiates by filename that it's different from the `src` version.
61 lines
2.6 KiB
Bash
Executable file
61 lines
2.6 KiB
Bash
Executable file
#!/bin/bash
|
|
|
|
# CI ENV `GITHUB_REF` from Github Actions CI provides the tag or branch that triggered the build
|
|
# See `github.ref`: https://docs.github.com/en/actions/reference/context-and-expression-syntax-for-github-actions#github-context
|
|
# https://docs.github.com/en/actions/reference/environment-variables
|
|
function _update_versions_json
|
|
{
|
|
# Extract the version tag, truncate `<PATCH>` version and any suffix beyond it.
|
|
local MAJOR_MINOR
|
|
MAJOR_MINOR=$(grep -oE 'v[0-9]+\.[0-9]+' <<< "${GITHUB_REF}")
|
|
# Github Actions CI method for exporting ENV vars to share across a jobs steps
|
|
# https://docs.github.com/en/actions/reference/workflow-commands-for-github-actions#setting-an-environment-variable
|
|
echo "DOCS_VERSION=${MAJOR_MINOR}" >> "${GITHUB_ENV}"
|
|
|
|
if [[ -z "${MAJOR_MINOR}" ]]
|
|
then
|
|
echo "Could not extract valid \`v<MAJOR>.<MINOR>\` substring, exiting.."
|
|
exit 1
|
|
fi
|
|
|
|
local VERSIONS_JSON='versions.json'
|
|
local IS_VALID
|
|
IS_VALID=$(jq '.' "${VERSIONS_JSON}")
|
|
|
|
if [[ ! -f "${VERSIONS_JSON}" ]] || [[ -z "${IS_VALID}" ]]
|
|
then
|
|
echo "'${VERSIONS_JSON}' doesn't exist or is invalid. Creating.."
|
|
echo '[{"version": "edge", "title": "edge", "aliases": []}]' > "${VERSIONS_JSON}"
|
|
fi
|
|
|
|
|
|
# Only add this tag version the first time it's encountered:
|
|
local VERSION_EXISTS
|
|
VERSION_EXISTS=$(jq --arg version "${MAJOR_MINOR}" '[.[].version == $version] | any' "${VERSIONS_JSON}")
|
|
|
|
if [[ "${VERSION_EXISTS}" == "true" ]]
|
|
then
|
|
echo "${MAJOR_MINOR} docs are already supported. Nothing to change, exiting.."
|
|
exit 1
|
|
else
|
|
echo "Added support for ${MAJOR_MINOR} docs."
|
|
# Add any logic here if you want the version selector to have a different label (`title`) than the `version` URL/subdirectory.
|
|
local TITLE=${TITLE:-${MAJOR_MINOR}}
|
|
|
|
# Assumes the first element is always the "latest" unreleased version (`edge` for us), and then newest version to oldest.
|
|
# `jq` takes the first array element of array as slice, concats with new element, then takes the slice of remaining original elements to concat.
|
|
# Thus assumes this script is always triggered by newer versions, no older major/minor releases as our build workflow isn't setup to support rebuilding older docs.
|
|
local UPDATED_JSON
|
|
UPDATED_JSON=$(jq --arg version "${MAJOR_MINOR}" --arg title "${TITLE}" \
|
|
'.[:1] + [{version: $version, title: $title, aliases: []}] + .[1:]' \
|
|
"${VERSIONS_JSON}"
|
|
)
|
|
|
|
# See `jq` FAQ advising this approach to update file:
|
|
# https://github.com/stedolan/jq/wiki/FAQ
|
|
echo "${UPDATED_JSON}" > tmp.json && mv tmp.json "${VERSIONS_JSON}"
|
|
fi
|
|
}
|
|
|
|
_update-versions-json
|