Tugboat is a system that builds a working preview of a website for any branch, tag, commit, or pull request in a git repository. It can automatically create these previews for pull requests by integrating with GitHub, GitLab, or Bitbucket git repositories.
This document aims to provide the information required to use Tugboat. It includes tutorials, examples, and references for all experience levels.
This document is open-source, and is available on GitHub. If you have any suggestions or other feedback about this document, we are happy to hear it! Open a GitHub issue or email us at support@tugboatqa.com.
The Hugo Learn Theme is included in this repo as a git subtree. To update the theme, find the latest tag at https://github.com/matcornic/hugo-theme-learn/releases and run the following
export TAG=2.4.0
git subtree pull --prefix themes/hugo-theme-learn https://github.com/matcornic/hugo-theme-learn.git $TAG --squash
Redirects for historic URLs are maintained in static/.htaccess
. These can be tested using
Smolder config file in test/smolder.yaml
. The tests need to be run against a
live instance, like a Tugboat preview.
cat test/smolder.yaml | docker run -i mcameron/smolder pr125-mcktkhcj8krhxo5oaa7emgv5gcnf5e5l.tugboatqa.com
This document is licensed as Creative Commons Attribution-NonCommercial-ShareAlike CC BY-NC-SA.
Everything not covered above is licensed under the MIT license.