From 56cc2ae596bb38964303a89285cb87fc2b7eb98f Mon Sep 17 00:00:00 2001 From: Pieter-Jan Briers Date: Sun, 14 Jul 2024 21:39:51 +0200 Subject: [PATCH] Robust.Cdn private forks update. (#260) --- .../server-hosting/setting-up-robust-cdn.md | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/src/en/server-hosting/setting-up-robust-cdn.md b/src/en/server-hosting/setting-up-robust-cdn.md index 0cd5a92d1..1bf8ba1b2 100644 --- a/src/en/server-hosting/setting-up-robust-cdn.md +++ b/src/en/server-hosting/setting-up-robust-cdn.md @@ -259,15 +259,19 @@ For example: [Wizard's Den builds](https://wizards.cdn.spacestation14.com/fork/w ## Private forks -```admonish failure -This feature is currently not usable as the watchdog lacks Basic auth support. -``` - -A fork can be marked as "private". This prevents Robust.Cdn from giving unauthorized people access to server builds, which is desirable for forks with secret content. +A fork can be marked as "private". This prevents Robust.Cdn from giving unauthorized people access to server builds, which is desirable for forks with secret content. Access is restricted via HTTP Basic authentication. Usernames and passwords for this can be configured in the fork configuration. -When enabled, access to server builds is restricted behind HTTP Basic authentication. Usernames and passwords for this can be configured in the fork configuration. +To give the watchdog access to these builds, you can configure it as such in the instance update configuration: -TODO: Watchdog setup guide here. +```yml +UpdateType: "Manifest" +Updates: + # Replace with your own Robust.Cdn URL and fork ID. + ManifestUrl: "https:///fork//manifest" + Authentication: + Username: foobar + Password: baz +``` ## Builds file layout @@ -294,7 +298,7 @@ If you were hosting an existing installation of Robust.Cdn from before multi-for As part of multi-fork and manifest support, the following changes will need to be made to your setup, at the bare minimum: * `Cdn.UpdateToken` in configuration has been moved to fork configuration. -* `Cdn.VersionDiskPath` has effectively been changed to `Manifest.FileDiskPath`. **Note that the file layout is different, you will need to manually move the builds one folder down to be underneath the folder (see above).** +* `Cdn.VersionDiskPath` has effectively been changed to `Manifest.FileDiskPath`. **Note that the file layout is different, you will need to manually move the builds one folder down to be underneath the fork folder (see above).** Robust.Cdn will automatically migrate your existing CDN content database so that all version information stored within gets assigned a fork. You must set `Cdn.DefaultFork` in the configuration so it knows what fork to assign these versions to. Existing URLs (for replays etc) will keep working after this, as configuring `Cdn.DefaultFork` will make the CDN internally map the old `/version/{version}/*` URLs to the new ones under the specified fork.