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
|
---
authors:
- Adrien Poupin
date: 2016-11-01
linktitle: Deployment with rsync
toc: true
menu:
main:
parent: tutorials
next: /tutorials/creating-a-new-theme
prev: /tutorials/automated-deployments
title: Easy deployments with rsync
weight: 11
---
# How to build and deploy with hugo and rsync
We assume here that you have an access to your web host with SSH. In that case, as you will see, deployment is very simple. We also assume that you have a functional static site with hugo installed.
The spoil is, you can deploy your entire site with a command that looks like this:
```bash
hugo && rsync -avz --delete public/ www-data@ftp.topologix.fr:~/www/
```
As you will see, we put it in a shell script file, which makes building and deployment as easy as executing `./deploy`.
## Installing SSH Key
If it is not done yet, we will make an automated way to SSH to your server. If you have already installed an SSH key, switch to the next section.
First, install the ssh client. On Debian/Ubuntu/derivates, enter `sudo apt-get install openssh-client`.
Then generate your ssh key by entering the following commands:
```
~$ cd && mkdir .ssh & cd .ssh
~/.ssh/$ ssh-keygen -t rsa -q -C "For SSH" -f rsa_id
~/.ssh/$ cat >> config <<EOF
Host HOST
Hostname HOST
Port 22
User USER
IdentityFile ~/.ssh/rsa_id
EOF
```
Don't forget to replace the `HOST` and `USER` values with your own ones. Then copy your ssh public key to the remote server:
```
~/.ssh/$ ssh-copy-id -i rsa_id.pub USER@HOST.com
```
Now you can easily connect to the remote server:
```
~$ ssh user@host
Enter passphrase for key '/home/mylogin/.ssh/rsa_id':
```
And you've done it!
## Shell script
We will put the first command in a script at the root of your hugo tree:
```
~/websites/topologix.fr$ editor deploy
```
Here you put the following content. Replace the `USER`, `HOST` and `DIR` values with your own.
```
#!/bin/sh
USER=my-user
HOST=my-server.com
DIR=my/directory/to/topologix.fr/ # might sometimes be empty!
hugo && rsync -avz --delete public/ ${USER}@${HOST}:~/${DIR}
exit 0
```
Note that `DIR` is the relative path from the remote user's home. If you have to specify a full path (for instance `/var/www/mysite/`) you must change `~/${DIR}` to `${DIR}` inside the command line. For most cases you should not have to.
Save and close, and make the `deploy` file executable:
```
~/websites/topologix.fr$ chmod +x deploy
```
Now you only have to enter the following command to deploy and update your website:
```
~/websites/topologix.fr$ ./deploy
Started building sites ...
Built site for language en:
0 draft content
0 future content
0 expired content
5 pages created
0 non-page files copied
0 paginator pages created
0 tags created
0 categories created
total in 56 ms
sending incremental file list
404.html
index.html
index.xml
sitemap.xml
cours-versailles/index.html
exercices/index.html
exercices/index.xml
exercices/barycentre-et-carres-des-distances/index.html
post/
post/index.html
sujets/index.html
sujets/index.xml
sujets/2016-09_supelec-jp/index.html
tarifs-contact/index.html
sent 9,550 bytes received 1,708 bytes 7,505.33 bytes/sec
total size is 966,557 speedup is 85.86
```
And it's done!
|
