Rocket League Mapmaking Website Documentation

• Guide by Mr Swaggles
• Site design by ghostrider-05
• Webdev trickery by wejrox

Deployment

Note

These steps will currently only work for the main rocketleaguemapmaking.com domain. If you wish to view this branch or a PR remotely, visit the developer site or the subdomain in the PR actions.

This site can be executed as a docker container on the host machine.

To update the site on the host machine, run the deploy workflow on the default branch with the following inputs:

• version: the version to deploy. Generally the same as the version in package.json.
• push (default: true). Controls whether to push the built image to Docker hub. If deploy is enabled and push is disabled, the server will use an already pushed image with the same version, or fail.
• deploy (default: true). Disable this to only build (and push) the Docker Image without deploying it.
• webhook message (default: true): send a Discord message with the deployment details when the workflow is finished.

See the GitHub documentation for how to run a workflow manually.

Manual update steps

1. Install Docker-CE on the host machine. Docker (non-ce) should also work but is not tested.
2. Clone this repository.
3. Build image not on host with docker build . -t rocketleaguemapmaking/rlmm:<VERSION>
4. Push to dockerhub with docker login; docker push rocketleaguemapmaking/rlmm:<BUILD_VERSION>
5. Navigate into the root of the repository on the host.
6. Execute sh deployment/update_and_deploy.sh <BUILD_VERSION>, e.g. sh deployment/update_and_deploy.sh 0.1.0 on host
   • This container will run in the background, and you can access the website.
   • To view all docker containers, execute docker ps -a, which are ordered by age.
   • To view the NGINX logs of a container, execute docker logs <container_name>.
   • To stop the service, execute docker stop rlmm
7. Execute sh deployment/move_dummyassets.sh to copy in the Not So Dummy Assets.
8. Access the site at the correct URL (rocketleaguemapmaking.com).

Contributing documentation

Read the contribution documentation for guidelines when contributing.

Certificate Renewal

The certificate is renewed by the deployment/renewcert.sh script run using a cron job.