mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
ba45da9d03
32356e4e Fix typo in header of shortcode-templates.md c8f1a2d2 Correct code example for index template function bfa6a55d Escape code fencing ff8b2f99 Fix typos in deployment with wercker tutorial 557c36e8 theme: Merge commit '7fbb4bed25001182bfeb91f79db0f0c1936582ee' 7fbb4bed Squashed 'themes/gohugoioTheme/' changes from 7dd8a302..ca53082d ce31cee0 Add "See Also" config 158cee1b Make the tags into keywords 61600be6 Add a note to the related section 49edb5a2 Relase 0.27.1 c9bbc001 releaser: Add release notes to /docs for release of 0.27.1 213c6c3b Add bugs poster 8b4590cd Add KeyCDN integration tutorial 2b277859 Add tutorial videos to several docs pages 950fef1f Update roadmap to link to the correct milestones page 496f5bf6 Rename relnotes d6f9378d Bump Netlify versions to 0.27 087fde7f Update 0.27 release notes 603f94ae docs: Document Related Content 3790f6a3 releaser: Bump versions for release of 0.27 0948868c releaser: Add release notes to /docs for release of 0.27 git-subtree-dir: docs git-subtree-split: 32356e4eabe357ae914f4d1d59e8ae31ce936723
247 lines
8.1 KiB
Markdown
247 lines
8.1 KiB
Markdown
---
|
|
title: Host-Agnostic Deploys with Nanobox
|
|
linktitle: Host-Agnostic Deploys with Nanobox
|
|
description: Easily deploy Hugo to AWS, DigitalOcean, Google, Azure, and more...
|
|
date: 2017-08-24
|
|
publishdate: 2017-08-24
|
|
lastmod: 2017-08-24
|
|
categories: [hosting and deployment]
|
|
keywords: [nanobox,deployment,hosting,aws,digitalocean,azure,google,linode]
|
|
authors: [Steve Domino]
|
|
menu:
|
|
docs:
|
|
parent: "hosting-and-deployment"
|
|
weight: 05
|
|
weight: 05
|
|
sections_weight: 05
|
|
draft: false
|
|
aliases: [/tutorials/deployment-with-nanobox/]
|
|
toc: true
|
|
---
|
|
|
|
|
|
|
|
## Before You Begin
|
|
|
|
Nanobox provides an entire end-to-end workflow for developing and deploying applications. Using Nanobox to deploy also means you'll use it to develop your application.
|
|
|
|
{{% note %}}
|
|
If you're already using Nanobox and just need deployment instructions, you can skip to [Deploying Hugo with Nanobox](#deploying-hugo-with-nanobox)
|
|
{{% /note %}}
|
|
|
|
|
|
## What You'll Need
|
|
|
|
With Nanobox you don't need to worry about having Golang or Hugo installed. They'll be installed as part of the development environment created for you.
|
|
|
|
To get started you'll just need the following three items:
|
|
|
|
* [A Nanobox Account](https://nanobox.io) - Signup is free
|
|
* [Nanobox Desktop](https://dashboard.nanobox.io/download) - The free desktop development tool
|
|
* An account with a hosting provider such as:
|
|
- [AWS](https://aws.amazon.com/)
|
|
- [DigitalOcean](https://www.digitalocean.com/)
|
|
- [Linode](https://www.linode.com/)
|
|
- Azure (coming)
|
|
- Google (coming)
|
|
- [Roll Your Own](https://docs.nanobox.io/providers/create/)
|
|
|
|
### Before We Begin
|
|
|
|
There are a few things to get out of the way before diving into the guide. To deploy, you'll need to make sure you have connected a host account to your Nanobox account, and launched a new application.
|
|
|
|
#### Connect a Host Account
|
|
|
|
Nanobox lets you choose where to host your application (AWS, DigitalOcean, Google, Azure, etc.). In the [Hosting Accounts](https://dashboard.nanobox.io/provider_accounts) section of your Nanobox dashboard [link your Nanobox account with your host](https://docs.nanobox.io/providers/hosting-accounts/).
|
|
|
|
#### Launch a New Application on Nanobox
|
|
|
|
[Launching a new app on Nanobox](https://docs.nanobox.io/workflow/launch-app/) is very simple. Navigate to [Launch New App](https://dashboard.nanobox.io/apps/new) in the dashboard, and follow the steps there. You'll be asked to name your app, and select a host and region.
|
|
|
|
With those out of the way you're ready to get started!
|
|
|
|
|
|
## Getting Started
|
|
|
|
{{% note %}}
|
|
If you already have a functioning Hugo app, you can skip to [Configure Hugo to run with Nanobox](#configure-hugo-to-run-with-nanobox)
|
|
{{% /note %}}
|
|
|
|
To get started, all you'll need an empty project directory. Create a directory wherever you want your application to live and `cd` into it:
|
|
|
|
`mkdir path/to/project && cd path/to/project`
|
|
|
|
### Configure Hugo to run with Nanobox
|
|
|
|
Nanobox uses a simple config file known as a [boxfile.yml](https://docs.nanobox.io/boxfile/) to describe your application's infrastructure. In the root of your project add the following `boxfile.yml`:
|
|
|
|
{{< code file="boxfile.yml" >}}
|
|
run.config:
|
|
|
|
# use the static engine
|
|
engine: static
|
|
engine.config:
|
|
|
|
# tell the engine where to serve static assets from
|
|
rel_dir: public
|
|
|
|
# enable file watching for live reload
|
|
fs_watch: true
|
|
|
|
# install hugo
|
|
extra_steps:
|
|
- bash ./install.sh
|
|
|
|
deploy.config:
|
|
|
|
# generate site on deploy
|
|
extra_steps:
|
|
- hugo
|
|
|
|
{{< /code >}}
|
|
|
|
{{% note %}}
|
|
If you already have a functioning Hugo app, which should now be configured, you can skip to [Deploying Hugo with Nanobox](#deploying-hugo-with-nanobox).
|
|
{{% /note %}}
|
|
|
|
### Installing Hugo
|
|
|
|
Nanobox uses Docker to create instant, isolated, development environments. Because of this, you'll need to make sure that during development you have Hugo available.
|
|
|
|
Do this by add a custom install script at the root of your project that will install Hugo automatically for you:
|
|
|
|
{{< code file="install.sh" >}}
|
|
|
|
#!/bin/bash
|
|
|
|
if [[ ! -f /data/bin/hugo ]]; then
|
|
cd /tmp
|
|
wget https://github.com/gohugoio/hugo/releases/download/v0.25.1/hugo_0.25.1_Linux-64bit.tar.gz
|
|
tar -xzf hugo_0.25.1_Linux-64bit.tar.gz
|
|
mv hugo /data/bin/hugo
|
|
cd -
|
|
rm -rf /tmp/*
|
|
fi
|
|
|
|
{{< /code >}}
|
|
|
|
{{% note %}}
|
|
If the install script fails during `nanobox run` you may need to make it executable with `chmod +x install.sh`
|
|
{{% /note %}}
|
|
|
|
### Generating a New Hugo App
|
|
|
|
You'll generate your new application from inside a Nanobox console (this is why you don't need to worry about having Golang or Hugo installed).
|
|
|
|
Run the following command to drop into a Nanobox console (inside the VM) where your codebase is mounted:
|
|
|
|
```
|
|
nanobox run
|
|
```
|
|
|
|
|
|
|
|
Once inside here use the following steps to create a new Hugo application:
|
|
|
|
```
|
|
# cd into the /tmp dir to create an app
|
|
cd /tmp
|
|
|
|
# generate the hugo app
|
|
hugo new site app
|
|
|
|
# cd back into the /app dir
|
|
cd -
|
|
|
|
# copy the generated app into the project
|
|
shopt -s dotglob
|
|
cp -a /tmp/app/* .
|
|
```
|
|
|
|
### Install a theme
|
|
|
|
`cd` into the `themes` directory and clone the `nanobox-hugo-theme` repo:
|
|
|
|
```
|
|
cd themes
|
|
git clone https://github.com/sdomino/nanobox-hugo-theme
|
|
```
|
|
|
|
To use the theme *either* copy the entire `config.toml` that comes with the theme, or just add the theme to your existing `config.toml`
|
|
|
|
```
|
|
# copy the config.toml that comes with the theme
|
|
cp ./themes/nanobox-hugo-theme/config.toml config.toml
|
|
|
|
# or, add it to your existing config.toml
|
|
theme = "nanobox-hugo-theme"
|
|
```
|
|
|
|
{{% note %}}
|
|
It is not intended that you use the `nanobox-hugo-theme` as your actual theme. It's simply a theme to start with and should be replaced.
|
|
{{% /note %}}
|
|
|
|
### View Your App
|
|
|
|
To view your application simply run the following command from a Nanobox console:
|
|
|
|
```
|
|
hugo server --bind="0.0.0.0" --baseUrl=$APP_IP
|
|
```
|
|
|
|
|
|
|
|
With that you should be able to visit your app at the given IP:1313 address
|
|
|
|
{{% note %}}
|
|
You can [add a custom DNS alias](https://docs.nanobox.io/cli/dns/#add) to make it easier to access your app. Run `nanobox dns add local hugo.dev`. After starting your server, visit your app at [hugo.dev:1313](http://hugo.dev:1313)
|
|
{{% /note %}}
|
|
|
|
### Develop, Develop, Develop
|
|
|
|
{{% note %}}
|
|
IMPORTANT: One issue we are aware of, and actively investigating, is livereload. Currently, livereload does not work when developing Hugo applications with Nanobox.
|
|
{{% /note %}}
|
|
|
|
With Hugo installed you're ready to go. Develop Hugo like you would normally (using all the generators, etc.). Once your app is ready to deploy, run `hugo` to generate your static assets and get ready to deploy!
|
|
|
|
|
|
## Deploying Hugo with Nanobox
|
|
|
|
{{% note %}}
|
|
If you haven't already, make sure to [connect a hosting account](#connect-a-host-account) to your Nanobox account, and [launch a new application](#launch-a-new-application-on-nanobox) in the Dashboard.
|
|
{{% /note %}}
|
|
|
|
To deploy your application to Nanobox you simply need to [link your local codebase](https://docs.nanobox.io/workflow/deploy-code/#add-your-live-app-as-a-remote) to an application you've created on Nanobox. That is done with the following command:
|
|
|
|
```
|
|
nanobox remote add <your-app-name>
|
|
```
|
|
|
|
{{% note %}}
|
|
You may be prompted to login using your ***Nanobox credentials*** at this time
|
|
{{% /note %}}
|
|
|
|
### Stage Your Application (optional)
|
|
|
|
Nanobox gives you the ability to [simulate your production environment locally](https://docs.nanobox.io/workflow/deploy-code/#preview-locally). While staging is optional it's always recommended, so there's no reason not to!
|
|
|
|
To stage your app simply run:
|
|
|
|
```
|
|
nanobox deploy dry-run
|
|
```
|
|
|
|
Now visit your application with the IP address provided.
|
|
|
|
|
|
|
|
### Deploy Your Application
|
|
|
|
Once everything checks out and you're [ready to deploy](https://docs.nanobox.io/workflow/deploy-code/#deploy-to-production), simply run:
|
|
|
|
```
|
|
nanobox deploy
|
|
```
|
|
|
|
Within minutes you're Hugo app will be deployed to your host and humming along smoothly. That's it!
|