Appendix I - Organization Guide

The information in this appendix is only pertinent to those contributors who are involved with the server hosting, operations and infrastructure for the Website v2. The sections contains links to the eclectic set of documentation maintained on GitHub which provides the detailed implementation notes required by developers and system administrators for the website.

Server Hosting

Provides details on the staging and production processes.

Document Link	Description
Deployments	If you are involved in testing the Boost website-v2, you might not need a full cloud deployment. This document describes potentially more convenient options, including using a local Docker composition, the existing staging site, or the existing production site. If you are involved in the C++ Alliance’s development efforts, code may be checked in directly to the staging and production sites, so another site isn’t needed.
GCP Notes	The website is hosted on Google Cloud Platform in a project named "boostorg-project1" within a CPPAlliance account. This document describes the Kubernetes cluster running in the us-central1 region, the Memorystore instance for each environment, and Archive Registry of the Docker images for each website release.
Amazon AWS Notes	In the us-east-2 region AWS S3 buckets store the described content.
Fastly Notes	A Fastly CDN is configured as a front-end to the stage and production sites. This document describes the configuration steps.
Mailman Notes	Mailman-core servers have been installed to test a selection of REST API calls.
Website Admin	Contains some notes on staging synchronization.

Document Link

Description

Deployments

If you are involved in testing the Boost website-v2, you might not need a full cloud deployment. This document describes potentially more convenient options, including using a local Docker composition, the existing staging site, or the existing production site. If you are involved in the C++ Alliance’s development efforts, code may be checked in directly to the staging and production sites, so another site isn’t needed.

GCP Notes

The website is hosted on Google Cloud Platform in a project named "boostorg-project1" within a CPPAlliance account. This document describes the Kubernetes cluster running in the us-central1 region, the Memorystore instance for each environment, and Archive Registry of the Docker images for each website release.

Amazon AWS Notes

In the us-east-2 region AWS S3 buckets store the described content.

Fastly Notes

A Fastly CDN is configured as a front-end to the stage and production sites. This document describes the configuration steps.

Mailman Notes

Mailman-core servers have been installed to test a selection of REST API calls.

Website Admin

Contains some notes on staging synchronization.

Website Operations

Provides operational details, specifically for each release.

Document Link	Description
Documentation and Website Previews for The C++ Alliance	This section covers what contributors should know about the preview generation on cppalliance.github.io and other github repositories.
Jenkins Summary	Provides notes on the operation of Jenkins. A Jenkins build server is hosted on AWS at https://jenkins.cppalliance.org:8443. The server builds and publishes previews of the documentation for a number of GitHub repositories when pull requests are submitted.
Jenkins System and Job Information	This section goes into exhaustive detail on Jenkins output that can be used as a reference for any job.
Job Inventory	The current Jenkins job inventory.
Drone Docs	Provides operational details on the CPPAlliance Drone CI implementation.
Website Redirects	There are four subdomains which redirect to The C++ Alliance. The redirects act as shortcuts to quickly reach the Slack invitations page, or the main homepage. This section provides implementation details.

Document Link

Description

Documentation and Website Previews for The C++ Alliance

This section covers what contributors should know about the preview generation on cppalliance.github.io and other github repositories.

Jenkins Summary

Provides notes on the operation of Jenkins. A Jenkins build server is hosted on AWS at https://jenkins.cppalliance.org:8443. The server builds and publishes previews of the documentation for a number of GitHub repositories when pull requests are submitted.

Jenkins System and Job Information

This section goes into exhaustive detail on Jenkins output that can be used as a reference for any job.

Job Inventory

The current Jenkins job inventory.

Drone Docs

Provides operational details on the CPPAlliance Drone CI implementation.

Website Redirects

There are four subdomains which redirect to The C++ Alliance. The redirects act as shortcuts to quickly reach the Slack invitations page, or the main homepage. This section provides implementation details.

Appendix I - Organization Guide

Server Hosting

Website Operations

See Also