Skip to content

Commit 2a78995

Browse files
committed
Add help for Cloudflare R2
1 parent c020af2 commit 2a78995

File tree

1 file changed

+23
-0
lines changed

1 file changed

+23
-0
lines changed

README.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,29 @@ If you'd like to sign your images using Cosign:
5151
gh secret set SIGNING_SECRET < cosign.key
5252
```
5353

54+
### Set up Cloudflare R2 for ISO storage
55+
56+
By default, the CI will upload built ISO images as Github Artifacts. These ISOs
57+
can get quite big and Artifact storage is limited, so you may want to upload the
58+
ISOs somewhere else, like the free tier of Cloudflare R2.
59+
60+
Follow these instructions to set that up:
61+
62+
1. Sign up to the free tier of [Cloudflare R2](https://www.cloudflare.com/developer-platform/products/r2/)
63+
2. Create a new bucket, with whatever name you want. Set the location to whatever you want. The free tier
64+
only gives you access to the Standard storage class, so leave that selected.
65+
3. Now that you have a bucket, you need credentials to access it. Click on the API selection button, and
66+
then on "Manage API tokens". In the next screen, click the "Create Account API token" button. Select
67+
"Object Read & Write" permissions, and apply it only to the specific bucket you just created, and then
68+
click on the "Create Account API Token" button. Note down the credentials displayed in the next screen.
69+
4. In Github, add the following new repository secrets:
70+
- `R2_ACCOUNT_ID`: your cloudflare account ID (you can find it in the URL of the Cloudflare dashboard: `https://dash.cloudflare.com/<R2_ACCOUNT_ID>/home`)
71+
- `R2_ACCESS_KEY_ID`: Access Key ID for your API token
72+
- `R2_SECRET_ACCESS_KEY`: Secret Access Key for your API token
73+
- `R2_BUCKET`: your bucket name
74+
5. In the `build-iso` job of [`build-iso.yml`](/.github/workflows/build-iso.yml), uncomment the secret
75+
definitions for the secrets you just defined and change `upload-to-cloudflare` to `true`.
76+
5477
## Customizing your respin
5578

5679
Now you're ready to make your respin your own!

0 commit comments

Comments
 (0)