Skip to content

Administration

Jump to bottom
antitree edited this page Sep 7, 2017 · 1 revision

The following details the hosting information about the site. This is placed here at a time when we're hacking on things so it's subject to change.

Overview

The site is hosted on Github Pages and fronted by CloudFlare.

  • HTML is hosted by Github, multiples members have admin permissions
  • DNS is hosted by CloudFlare using antitree's account(FIXME).
  • Domain is hosted on NameCheap.com. 2017-09-07 Hoopycat and Antitree have credentials.
  • Continuous Integration is performed by Travis-CI.org. 2017-09-07 Access currently setup using Antitree's github token.

Point of Contacts

Contact @whoever/@whomever on Slack for additional support.

Github

The hosting on Github comes with a caveat. Currently you can only have one Github page hosted per organization. We've seen that Pelican can somehow delete the hosting configuration during a make publish github and we don't know why right now. In any case, if the site goes down, you should go into the Repo settings and reconfigure it to use a "Custom Domain" of "www.interlockroc.org".

Cloudflare

Cloudflare has a checkered past of being a community/FOSS friendly organization but we've chosen it out of necessity. Currently, Cloudflare is a CDN that provides HTTPS support for our site, free-of-charge. This is using the default configuration on the Cloudflare page. DNS his hosted with them because that's how this works.

Travis CI

The .travis.yml file contains the necessary information for Travis CI. This can be tweaked but make sure that builds are successful. This may require the help of a Travis Adult.

Pelican

Pelican can often be misconfigured if it's running and out-of-date client or a module is missing. For example if you don't have a required module included in your virtualenv or machine, Pelican will try to build anyways without any warnings. Make sure that you thoroughly review before pushing it back up.

For admins of the repo, you can use the make file configurations. The following commands may be useful:

  • make html will save everything into the "output" directory as HTML so you can preview it
  • make publish github this in theory should push it to the "master" branch which hosts the HTML content
  • make github IDK but seems relevant.
  • make publish again not sure.
Clone this wiki locally