[devdocsgjs/main: 1487/1867] docs: add infra and provisioning docs
- From: Andy Holmes <andyholmes src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [devdocsgjs/main: 1487/1867] docs: add infra and provisioning docs
- Date: Fri, 19 Nov 2021 23:48:06 +0000 (UTC)
commit 3dca41cb9cd9284f0a7d4669bedd99c6e3c32565
Author: Oliver Eyton-Williams <ojeytonwilliams gmail com>
Date: Fri Feb 12 16:59:44 2021 +0100
docs: add infra and provisioning docs
docs/maintainers.md | 31 +++++++++++++++++++++++++++++++
1 file changed, 31 insertions(+)
---
diff --git a/docs/maintainers.md b/docs/maintainers.md
index 5494c461..2343e2eb 100644
--- a/docs/maintainers.md
+++ b/docs/maintainers.md
@@ -88,6 +88,37 @@ If any issue arises, run `heroku rollback` to rollback to the previous version o
If this is your first deploy, make sure another maintainer is around to assist.
+## Infrastructure
+
+The bundled documents are available at downloads.devdocs.io and the documents themselves at
documents.devdocs.io. Download and document requests are proxied to S3 buckets
devdocs-downloads.s3.amazonaws.com and devdocs-documents.s3.amazonaws.com respectively.
+
+If there's ever a need to create a new proxy VM (and the `devdocs-proxy` snapshot is not available) then the
new vm should be provisioned as follows:
+
+```bash
+# we need at least nginx 1.19.x
+wget https://nginx.org/keys/nginx_signing.key
+apt-key add nginx_signing.key
+echo 'deb https://nginx.org/packages/mainline/ubuntu/ focal nginx' >> /etc/apt/sources.list
+echo 'deb-src https://nginx.org/packages/mainline/ubuntu/ focal nginx' >> /etc/apt/sources.list
+apt-get -y remove nginx-common
+apt-get -y update
+apt-get -y install nginx
+
+# the config is on github
+rm -rf /etc/nginx/*
+rm -rf /etc/nginx/.* 2> /dev/null
+git clone https://github.com/freeCodeCamp/devdocs-nginx-config.git /etc/nginx
+
+# at this point we need to add the certs from Cloudflare and test the config
+nginx -t
+
+# if nginx is already running, just
+# ps aux | grep nginx
+# find the number and kill it
+
+nginx
+```
+
## List of maintainers in alphabetical order
The following people (used to) maintain DevDocs:
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]