Skip to content

Latest commit

 

History

History
62 lines (53 loc) · 2.5 KB

README.md

File metadata and controls

62 lines (53 loc) · 2.5 KB
Raw

kobo-support-docker

This repository handles redirection and reverse proxying for our support-related websites.

  • support.kobotoolbox.org:
    1. If the request path matches something in files/redirections.conf, then the request is redirected;
    2. The request is reverse-proxied to https://kobotoolbox.github.io, which is our documentation website.
  • help.kobotoolbox.org:
    1. Requests to the base hostname are now redirected to the Discourse forum, https://community.kobotoolbox.org;
    2. Requests for anything else are redirected to https://support.kobotoolbox.org.
  • forum.kobotoolbox.org: this was the very short-lived original hostname for our Discourse forum. This redirect could probably be removed, but for now, it steers people to https://community.kobotoolbox.org.

This also handles redirection for the "apex" kobotoolbox.org domain and secondary domain names:

How to use

After making any modifications to the redirect rules or other NGINX configuration settings, build a new Docker image and push it to Docker Hub. Use the tag kobotoolbox/kobo-support-docker:

docker build -t kobotoolbox/kobo-support-docker .

Once the build completes, push it to Docker Hub:

docker push kobotoolbox/kobo-support-docker

The new image can now be used with cloud container services such as AWS ECS.

AWS Elastic Container Service (ECS)

To update this service running on ECS:

  1. Build and push a new Docker image as described above;
  2. Go to the ECS "Task definitions", currently at https://us-east-1.console.aws.amazon.com/ecs/v2/task-definitions;
  3. Select the latest revision and then click "Create new revision";
  4. Verify that "Image URI" is "kobotoolbox/kobo-support-docker:latest";
  5. Scroll all the way down and click "Create";
  6. You should now be viewing the new revision.
  7. Click "Deploy" and choose "Update service";
  8. Verify that "Cluster" is "support-redirector-cluster" and "Service" is "support-redirector-service";
  9. Scroll all the way down and hit "Update"!