Skip to content

Commit

Permalink
Add link to AWS Amplify scripts
Browse files Browse the repository at this point in the history
  • Loading branch information
rmoff committed Feb 28, 2024
1 parent 5a9fcab commit 0839a3c
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion content/post/antora-2.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,15 @@ categories:
- Antora
- GitHub
- Cloudflare
- AWS Amplify
---

:source-highlighter: rouge
:icons: font
:rouge-css: style
:rouge-style: github

At https://decodable.co[Decodable] we're migrating our docs platform onto https://antora.org/[Antora]. I wrote link:/2023/12/19/deploying-antora-with-github-actions-and-a-private-github-repo/[previously] about my escapades in getting cross-repository authentication working using https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#types-of-personal-access-tokens[Private Access Tokens] (PAT). These are fine for just a single user, but they're tied to that user, which isn't a good practice for deployment in this case.
At https://decodable.co[Decodable] we migrated our docs platform onto https://antora.org/[Antora]. I wrote link:/2023/12/19/deploying-antora-with-github-actions-and-a-private-github-repo/[previously] about my escapades in getting cross-repository authentication working using https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#types-of-personal-access-tokens[Private Access Tokens] (PAT). These are fine for just a single user, but they're tied to that user, which isn't a good practice for deployment in this case.

In this article I'll show how to use GitHub Apps and Installation Access Tokens (IAT) instead, and go into some detail on how we've deployed Antora. Our GitHub repositories are private which makes it extra-gnarly.

Expand Down Expand Up @@ -188,3 +189,11 @@ and the following repository variable
| Key | Value
| `CLOUDFLARE_ACCOUNT_ID` | Cloudflare Account ID
|===============================================================================================================================

== Addendum: Deploying Antora using AWS Amplify and GitHub Workflows

For `$REASONS` we ended up using AWS Amplify. You can find the build scripts https://gist.github.com/rmoff/867322d0ff0659084981d786d9048231[here]. There are three scripts:

1. Preview deployment (triggered by a PR creation)
2. Live deployment (triggered by a merge to `main`)
3. Teardown preview (triggered by a PR being closed)

0 comments on commit 0839a3c

Please sign in to comment.