blob: b297bca028b1571fbe59f15aa6a6d93e9e6730b4 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
---
title: Host on Netlify
description: Host your site on Netlify with continuous deployment.
categories: [hosting and deployment]
keywords: [hosting]
menu:
docs:
parent: hosting-and-deployment
toc: true
---
## Prerequisites
1. [Create a Netlify account]
2. [Install Git]
3. [Create a Hugo site] and test it locally with `hugo server`
4. Commit the changes to your local repository
4. Push the local repository to your [GitHub], [GitLab], or [Bitbucket] account
[Bitbucket]: https://bitbucket.org/product
[Create a Hugo site]: /getting-started/quick-start/
[Create a Netlify account]: https://app.netlify.com/signup
[GitHub]: https://github.com
[GitLab]: https://about.gitlab.com/
[Install Git]: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
## Procedure
This procedure will enable continuous deployment from a GitHub repository. The procedure is essentially the same if you are using GitLab or Bitbucket.
Step 1
: Log in to your Netlify account, navigate to the Sites page, press the **Add new site** button, and choose "Import an existing project" from the dropdown menu.
Step 2
: Select your deployment method.
![screen capture](netlify-step-02.png)
Step 3
: Authorize Netlify to connect with your GitHub account by pressing the **Authorize Netlify** button.
![screen capture](netlify-step-03.png)
Step 4
: Press the **Configure Netlify on GitHub** button.
![screen capture](netlify-step-04.png)
Step 5
: Install the Netlify app by selecting your GitHub account.
![screen capture](netlify-step-05.png)
Step 6
: Press the **Install** button.
![screen capture](netlify-step-06.png)
Step 7
: Click on the site's repository from the list.
![screen capture](netlify-step-07.png)
Step 8
: Set the site name and branch from which to deploy.
![screen capture](netlify-step-08.png)
Step 9
: Define the build settings, press the **Add environment variables** button, then press the **New variable** button.
![screen capture](netlify-step-09.png)
Step 10
: Create a new environment variable named `HUGO_VERSION` and set the value to the [latest version].
[latest version]: https://github.com/gohugoio/hugo/releases/latest
![screen capture](netlify-step-10.png)
Step 11
: Press the "Deploy my new site" button at the bottom of the page.
![screen capture](netlify-step-11.png)
Step 12
: At the bottom of the screen, wait for the deploy to complete, then click on the deploy log entry.
![screen capture](netlify-step-12.png)
Step 13
: Press the **Open production deploy** button to view the live site.
![screen capture](netlify-step-13.png)
## Configuration file
In the procedure above we configured our site using the Netlify user interface. Most site owners find it easier to use a configuration file checked into source control.
Create a new file named netlify.toml in the root of your project directory. In its simplest form, the configuration file might look like this:
{{< code file=netlify.toml >}}
[build.environment]
HUGO_VERSION = "0.126.0"
TZ = "America/Los_Angeles"
[build]
publish = "public"
command = "hugo --gc --minify"
{{< /code >}}
If your site requires Dart Sass to transpile Sass to CSS, the configuration file should look something like this:
{{< code file=netlify.toml >}}
[build.environment]
HUGO_VERSION = "0.126.0"
DART_SASS_VERSION = "1.77.1"
TZ = "America/Los_Angeles"
[build]
publish = "public"
command = """\
curl -LJO https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
tar -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
rm dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
export PATH=/opt/build/repo/dart-sass:$PATH && \
hugo --gc --minify \
"""
{{< /code >}}
|