This page covers Tugboat’s environment variables. If you’re looking for information on how to use custom environment variables with Tugboat, see: Create Custom Environment Variables.
Tugboat injects the following environment variables into every Service. These variables are available for the entire lifetime of a Service. This includes both build-time as well as run-time. So, they can be used in Build Scripts as well as run-time configuration files, etc.
$TUGBOAT_DEFAULT_SERVICE
- The friendly name of the default Service of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_ID
- The ID of the default Service of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_TOKEN
- The authentication token for the default Service of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_URL
- The full URL for the default Service of the current Preview. This is also the
default URL for the Preview itself.
$TUGBOAT_DEFAULT_SERVICE_URL_HOST
- The “host” part of the URL for the default Service of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_URL_PROTOCOL
- The “protocol” part of the URL for the default Service of the current
Preview.
$TUGBOAT_DEFAULT_SERVICE_URL_PATH
- The “path” part of the URL for the default Service of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_CONFIG_ALIASES
- A comma-separated list of aliases configured for the default Service
of the current Preview.
$TUGBOAT_DEFAULT_SERVICE_CONFIG_DOMAIN
- The configured domain for the default Service of the current Preview.
$TUGBOAT_PREVIEW_ID
- The ID of the current Preview.
$TUGBOAT_PREVIEW
- The ref name used to build the current Preview. This is an alias of $TUGBOAT_PREVIEW_REF
.
$TUGBOAT_PREVIEW_NAME
- The friendly name of the current Preview.
$TUGBOAT_PREVIEW_REF
- The ref name used to build the current Preview.
$TUGBOAT_PREVIEW_TYPE
- What type of preview this is. The value will be one of: branch
, tag
, commit
,
pullrequest
, or mergerequest
.
$TUGBOAT_PREVIEW_SHA
- The git SHA that the preview was built from.
$TUGBOAT_PROJECT_ID
- The ID of the project that the current Preview belongs to.
$TUGBOAT_PROJECT
- The friendly name of the project that the current Preview belongs to.
$TUGBOAT_REPO_ID
- The ID of the repo that the current Preview belongs to.
$TUGBOAT_REPO
- The friendly name of the repo that the current Preview belongs to.
$TUGBOAT_ROOT
- The filesystem location where the git repository is cloned.
$TUGBOAT_SERVICE_ID
- The ID of the current service.
$TUGBOAT_SERVICE
- The friendly name of the current Service. This is also the hostname used to reference this
Service container from other Services.
$TUGBOAT_SMTP
- The hostname of a Tugboat SMTP server that can be used to capture outbound email from the
Preview.
If a Service has an exposed HTTP port configured, the following variables are also available with information about the Service’s public URL
$TUGBOAT_SERVICE_TOKEN
- The authentication token for the Tugboat Service. This is used by the Tugboat HTTP
proxy to grant access to a Service and is passed through mostly as an informational value. Additional verification
could be done in the application if necessary.
$TUGBOAT_SERVICE_URL
- The full URL of the current Service.
$TUGBOAT_SERVICE_URL_PROTOCOL
- The “protocol” part of the current service’s URL.
$TUGBOAT_SERVICE_URL_HOST
- The “host” part of the current service’s URL.
$TUGBOAT_SERVICE_URL_PATH
- The “path” part of the current service’s URL.
$TUGBOAT_SERVICE_CONFIG_ALIASES
- A comma-separated list of aliases configured for the current service.
$TUGBOAT_SERVICE_CONFIG_DOMAIN
- The configured domain for the current service.
If a Preview was built from a Base Preview, the following variables are also available with information about the Base Preview.
$TUGBOAT_BASE_PREVIEW
- The ref name used to build the Base Preview. This is an alias of
$TUGBOAT_BASE_PREVIEW_REF
$TUGBOAT_BASE_PREVIEW_ID
- The ID of the Base Preview.
$TUGBOAT_BASE_PREVIEW_NAME
- The friendly name of the Base Preview.
$TUGBOAT_BASE_PREVIEW_REF
- The ref name used to build the Base Preview.
$TUGBOAT_BASE_PREVIEW_TYPE
- What type of preview the Base Preview is. The value will be one of: branch
,
tag
, commit
, pullrequest
, or mergerequest
.
$TUGBOAT_BASE_PREVIEW_TOKEN
- The authentication token of the Base Preview’s default Service.
$TUGBOAT_BASE_PREVIEW_URL
- The public URL for the Base Preview’s default Service.
$TUGBOAT_BASE_PREVIEW_URL_PROTOCOL
- The “protocol” part of the Base Preview’s default Service URL.
$TUGBOAT_BASE_PREVIEW_URL_HOST
- The “host” part of the Base Preview’s default Service URL.
$TUGBOAT_BASE_PREVIEW_URL_PATH
- The “path” part of the Base Preview’s default Service URL.
These variables are added to some of Tugboat’s images.
$DOCROOT
- On images that provide a webserver (such as tugboatqa/httpd
, tugboatqa/nginx
, or tugboatqa/php
images that have Apache installed), the $DOCROOT
environment variable points to the full path that Tugboat expects
your document root to live. It’s recommended to symlink your assets directory into place: e.g.
ln -snf "${TUGBOAT_ROOT}/build" "${DOCROOT}"
.These variables are injected into Tugboat Previews that are built from a Bitbucket repository.
$TUGBOAT_BITBUCKET_OWNER
- The owner of the Bitbucket repository.
$TUGBOAT_BITBUCKET_SLUG
- The URL-friendly name of the Bitbucket repository. See
https://confluence.atlassian.com/bitbucket/what-is-a-slug-224395839.html
These variables are only injected into Tugboat Previews that are built from a Bitbucket pull request.
$TUGBOAT_BITBUCKET_PR
- The Bitbucket pull request number.
$TUGBOAT_BITBUCKET_TITLE
- The title of the Bitbucket pull request.
$TUGBOAT_BITBUCKET_SOURCE
- The name of the pull request source branch.
$TUGBOAT_BITBUCKET_DESTINATION
- The name of the pull request destination branch.
These variables are injected into Tugboat Previews that are built from a raw git repository.
$TUGBOAT_GIT_REPO
- The address of the git repository.These variables are injected into Tugboat Previews that are built from a GitHub repository.
$TUGBOAT_GITHUB_OWNER
- The owner of the GitHub repository.
$TUGBOAT_GITHUB_REPO
- The name of the GitHub repository.
These variables are only injected into Tugboat Previews that are built from a GitHub pull request.
$TUGBOAT_GITHUB_PR
- The GitHub pull request number.
$TUGBOAT_GITHUB_TITLE
- The title of the GitHub pull request.
$TUGBOAT_GITHUB_HEAD
- The name of the pull request head branch.
$TUGBOAT_GITHUB_BASE
- The name of the pull request base branch.
These variables are injected into Tugboat Previews that are built from a GitLab repository.
$TUGBOAT_GITLAB_NAMESPACE
- The namespace of the GitLab repository.
$TUGBOAT_GITLAB_PROJECT
- The project name of the GitLab repository.
These variables are only injected into Tugboat Previews that are built from a GitLab merge request.
$TUGBOAT_GITLAB_MR
- The GitLab merge request number.
$TUGBOAT_GITLAB_TITLE
- The title of the GitLab merge request.
$TUGBOAT_GITLAB_SOURCE
- The name of the merge request source branch.
$TUGBOAT_GITLAB_TARGET
- The name of the merge request target branch.
These variables are injected into a Tugboat Previews that are built from a Stash or Bitbucket Server repository.
$TUGBOAT_STASH_PROJECT
- The project where the repository lives.
$TUGBOAT_STASH_SLUG
- The URL-friendly name of the repository. See
https://confluence.atlassian.com/bitbucket/what-is-a-slug-224395839.html
These variables are only injected into Tugboat Previews that are built from a Stash or Bitbucket Server pull request.
$TUGBOAT_STASH_PR
- The pull request number.
$TUGBOAT_STASH_TITLE
- The title of the pull request.
$TUGBOAT_STASH_SOURCE
- The name of the pull request source branch.
$TUGBOAT_STASH_DESTINATION
- The name of the pull request destination branch.