Deploy a site

Once you have a working Wagon site, you probably want to see it working online, with the back-office and everything. That's the role of the Locomotive engine.

📘

The only requirement is to have somewhere (it can be online or locally) a running engine and an account. Check out the engine installation guide for more information.

Usage

wagon deploy ENV [PATH]

ENV references the target platform in your config/deploy.yml file.

If the target doesn't exist, the deploy command will ask you for the information about the platform you want to deploy your site to. Then, it will create the site on the Locomotive engine and will update your config/deploy.yml accordingly.

📘

You can have as many targets (test, …etc) as you want.



Options

NameDescription
-r one, [--resources=one two three]Deploy the resource(s) passed in argument
-d, [--data], [--no-data]Deploy the data associated with editable elements, e.g. sections, content entries, the editable elements and the translations (by default, they are not)
-f filename, [--filter=filename]Filter the resource(s) to be deployed by their filename and extension. Must be used in conjunction with the '-r' option.
-e, [--env=ENV]Deploy data previously synced from a remote LocomotiveCMS engine. Use -e in conjunction with the environment to be deployed.
-v, [--verbose], [--no-verbose]Show each resource being deployed. Display the full error stack trace if an error occurs.


Resource Types

In some cases, you may not wish to deploy the entire site. For instance, if the site is already deployed and you have modified a number of snippets or a single page.

To deploy a particular resource, use the resource option (-r) and specify one or more resource(s).

NameUsageDescription
sitewagon deploy ENV -r siteDeploys metafields_schema.yml. May be used in conjunction with the data option (-d) to deploy the contents of site.yml.
pageswagon deploy ENV -r pagesDeploys all pages.
snippetswagon deploy ENV -r snippetsDeploys all snippets.
theme_assetswagon deploy ENV -r theme_assetsDeploys all theme_assets (everything contained within the /public folder, i.e. fonts, images, javascripts, samples, stylesheets).
content_typeswagon deploy ENV -r content_typesDeploys all content_types.
content_entrieswagon deploy ENV -r content_entries -dDeploys all content_entries. Must be used in conjunction with the data option (-d).

Additionally, some resources may be deployed invididually by using the filename option (-f).

NameUsageDescription
pageswagon deploy ENV -r pages -f page-slug.liquidDeploys the specified page.
theme_assetswagon deploy ENV -r theme_assets -f filename.extensionDeploys the specified asset.
content_entrieswagon deploy ENV -r content_entries -f content_type_slug -dDeploys the content_entries of the specified content_type.


Further Examples

Given the below /config/deploy.yml file,

staging:
  host: station.locomotive.works
  handle: my-site-staging
  email: [email protected]
  api_key: 373e4330e47d30456221caa4e6b174428b9a1de

live:
  host: station.locomotive.works
  handle: my-site-live
  email: [email protected]
  api_key: 373e4330e47d30456221caa4e6b174428b9a1de

The following command deploys the entire site (without data) to the staging platform.

wagon deploy staging

The following command deploys all pages to the live platform.

wagon deploy live -r pages -v

The following command deploys all content_types with content_entries to the live platform.

wagon deploy live -r content_types content_entries -d

The following command deploys the entire site (including data synced from the staging platform) to the live platform. The verbose option has been included to display the full error stack trace if it occurs.

wagon deploy live -d -e staging -v

👍 Thanks to greyskin for this cheatsheet:

📘

Deploying

Single: bundle exec wagon deploy [env] –r [pages, theme_assets, site] –f [path/filename.extension] –v

Multiple: bundle exec wagon deploy [env] –r [pages, sections, snippets, content_types, theme_assets, site] –v

Requirements:

  • resource must be plural (even for single deployment)
  • file must include extension
  • no single option for content_types, sections, snippets

Content Entries
Single: bundle exec wagon deploy [env] –r content_entries –f [content_type] -d –v
All: bundle exec wagon deploy [env] –r content_entries -d –v

Deleting

Single: bundle exec wagon delete [env] [page, section, snippet, content_type, site] [path/filename]

Multiple: bundle exec wagon delete [env] [pages, sections, snippets, content_types, theme_assets, site]

Requirements:

  • no extensions
  • no file extensions