doc: add faq docs

- [x] faq on how to get repository id and discussion category id
- [x] move checkout sooner in release image create
- [x] add secrets for image registry, username, and password to release test

Signed-off-by: jmeridth <[email protected]>

Author: jmeridth

.github/workflows/release.yaml

@@ -102,6 +102,7 @@ jobs:
         run: |
           echo "image-registry-password secret is not set"
           exit 1
+      - uses: actions/[email protected]
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@6524bf65af31da8d45b59e8c27de4bd072b392f5
       - name: Log in to the Container registry
@@ -110,7 +111,6 @@ jobs:
           registry: ${{ env.IMAGE_REGISTRY }}
           username: ${{ env.IMAGE_REGISTRY_USERNAME }}
           password: ${{ env.IMAGE_REGISTRY_PASSWORD}}
-      - uses: actions/[email protected]
       - name: Push Docker Image
         if: ${{ success() }}
         uses: docker/build-push-action@48aba3b46d1b1fec4febb7c5d0c644b249a11355
@@ -122,7 +122,7 @@ jobs:
             ${{ env.IMAGE_REGISTRY }}/${{ inputs.image-name }}:latest
             ${{ env.IMAGE_REGISTRY }}/${{ inputs.image-name }}:${{ needs.create_release.outputs.full-tag }}
             ${{ env.IMAGE_REGISTRY }}/${{ inputs.image-name }}:${{ needs.create_release.outputs.short-tag }}
-          platforms: linux/amd64
+          platforms: linux/amd64,linux/arm64
           provenance: false
           sbom: false
   create_discussion:

.github/workflows/test-release.yaml

@@ -18,5 +18,8 @@ jobs:
       create-discussion: true
     secrets:
       github-token: ${{ secrets.GITHUB_TOKEN }}
+      image-registry: ghcr.io
+      image-registry-username: ${{ github.actor }}
+      image-registry-password: ${{ secrets.GITHUB_TOKEN }}
       discussion-repository-id: ${{ secrets.DISCUSSION_REPOSITORY_ID }}
       discussion-category-id: ${{ secrets.DISCUSSION_CATEGORY_ID }}

Dockerfile

@@ -0,0 +1,2 @@
+FROM alpine
+CMD ["echo", "Hello World!!"]

docs/faq.md

@@ -0,0 +1,37 @@
+# Frequently Asked Questions
+
+## How to I get the repository ID to put in my Actions secrets for use with the reusable release workflow?
+
+You can get a repository's ID via the GitHub Rest API endpoint](https://docs.github.com/en/rest/repos/repos?apiVersion=2022-11-28#get-a-repository).  I found using the `gh` CLI tool to be the easiest way to get the repository ID.  You can use the following command to get the repository ID:
+
+change the `OWNER` and `REPO` to the repository you are interested in.
+
+```bash
+# GitHub CLI api
+# https://cli.github.com/manual/gh_api
+
+gh api \
+  -H "Accept: application/vnd.github+json" \
+  -H "X-GitHub-Api-Version: 2022-11-28" \
+  /repos/OWNER/REPO
+```
+
+## How do I get the discussion category ID to put in my Actions secrets for use with the reusable release workflow?
+
+You can get a repository's discussion category ID via the GitHub GraphQL API.  You can use the [GraphQL Explorer UI Tool](https://docs.github.com/en/graphql/overview/explorer) to get the discussion category ID.  You can use the following query to get the discussion category ID:
+
+change the `owner` and `name` to the repository you are interested in.
+
+```graphql
+query {
+  repository(owner: "jmeridth", name: "reusable-workflows") {
+    discussionCategories(first: 10) {
+      nodes {
+        # type: DiscussionCategory
+        id
+        name
+      }
+    }
+  }
+}
+```