Static HTML

A static HTML Tugboat Preview serves files exactly as they are found in the git repository.

Configure Tugboat

The Tugboat configuration is managed by a YAML file at .tugboat/config.yml in the git repository. Here’s a basic static HTML configuration you can use as a starting point, with comments to explain what’s going on:

 1services:
 2  # What to call the service hosting the site. Because there is only
 3  # one service, it is automatically set as the default service, which
 4  # does a few things
 5  #   1. Clones the git repository into the service container
 6  #   2. Exposes port 80 to the Tugboat HTTP proxy
 7  #   3. Routes requests to the preview URL to this service
 8  apache:
 9    # Use the available version of Apache by not specifying a version
10    image: tugboatqa/httpd
11
12    # A set of commands to run while building this service
13    commands:
14      # Commands that set up the basic preview infrastructure
15      init:
16        # Link the document root to the expected path. This example links the
17        # root of the git repository to the docroot
18        - ln -snf "${TUGBOAT_ROOT}" "${DOCROOT}"

Want to know more about something mentioned in the comments of this config file? Check out these topics:

Start Building Previews!

Once this Tugboat configuration file is committed to your git repository, you can start building previews!