diff options
author | Bjørn Erik Pedersen <[email protected]> | 2022-04-08 13:32:01 +0200 |
---|---|---|
committer | Bjørn Erik Pedersen <[email protected]> | 2022-04-08 13:32:01 +0200 |
commit | 5b5dcb8d5a4669e1768951b452cfd53c6b25825c (patch) | |
tree | c364895dfba48457afd2b83ceaae2e085fae0428 /docs/content/en/hosting-and-deployment | |
parent | ffe3eb9195e0f3184df9fc416d5f6ee12fdba91b (diff) | |
parent | ec920363cdeb687c8bcac9c242767d366fb058cb (diff) | |
download | hugo-5b5dcb8d5a4669e1768951b452cfd53c6b25825c.tar.gz hugo-5b5dcb8d5a4669e1768951b452cfd53c6b25825c.zip |
Merge commit 'ec920363cdeb687c8bcac9c242767d366fb058cb'
Diffstat (limited to 'docs/content/en/hosting-and-deployment')
3 files changed, 59 insertions, 4 deletions
diff --git a/docs/content/en/hosting-and-deployment/deployment-with-rclone.md b/docs/content/en/hosting-and-deployment/deployment-with-rclone.md new file mode 100644 index 000000000..e9feb765a --- /dev/null +++ b/docs/content/en/hosting-and-deployment/deployment-with-rclone.md @@ -0,0 +1,57 @@ +--- +title: Deployment with Rclone +linktitle: Deployment with Rclone +description: If you have access to your web host with SFTP/FTP/SSH/HTTP(DAV), you can use rclone to incrementally deploy your entire Hugo website. +date: 2021-08-09 +publishdate: 2021-08-09 +lastmod: 2021-08-09 +categories: [hosting and deployment] +keywords: [rclone,sftp,deployment] +authors: [Daniel F. Dickinson] +menu: + docs: + parent: "hosting-and-deployment" + weight: 80 +weight: 80 +sections_weight: 80 +draft: false +aliases: [/tutorials/deployment-with-rclone/] +toc: true +notesforauthors: +--- + +## Assumptions + +* A web host running a web server. This could be a shared hosting environment or a VPS. +* Access to your web host with any of the [protocols supported by rclone](https://rclone.org/#providers), such as SFTP. +* A functional static website built with Hugo +* Deploying from an [Rclone](https://rclone.org) compatible operating system +* You have [installed Rclone](https://rclone.org/install/). + +**NB**: You can remove ``--interactive`` in the commands below once you are comfortable with rclone, if you wish. Also, ``--gc`` and ``--minify`` are optional in the ``hugo`` commands below. + +## Getting Started + +The spoiler is that you can even deploy your entire website from any compatible OS with no configuration. Using SFTP for example: + +``` +hugo --gc --minify +rclone sync --interactive --sftp-host sftp.example.com --sftp-user www-data --sftp-ask-password public/ :sftp:www/ +``` + +## Configure Rclone for Even Easier Usage + +The easiest way is simply to run ``rclone config``. + +The [Rclone docs](https://rclone.org/docs/) provide [an example of configuring Rclone to use SFTP](https://rclone.org/sftp/). + +For the next commands, we will assume you configured a remote you named ``hugo-www`` + +The above 'spoiler' commands could become: + +``` +hugo --gc --minify +rclone sync --interactive public/ hugo-www:www/ +``` + +After you issue the above commands (and respond to any prompts), check your website and you will see that it is deployed. diff --git a/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md index 8d9cb0e63..bec8b36e4 100644 --- a/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md +++ b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md @@ -83,11 +83,11 @@ The Zone ID and API key are used to purge your zone – it’s not strictly need Now it’s time to push the newly created repository to GitLab: ``` -git remote add origin [email protected]:youruser/ciexample.git +git remote add origin [email protected]:youruser/ci-example.git git push -u origin master ``` -You can watch the progress and CI job output in your Gitlab project under “Pipelines”. +You can watch the progress and CI job output in your Gitlab project under “Pipelines”. After verifying your CI job ran without issues, first check that your GitLab page shows up under `https://youruser.gitlab.io/reponame/` (it might look broken depending on your browser settings as all links point to your KeyCDN zone – don’t worry about that) and then by heading to whatever Zone alias / Zone URL you defined. diff --git a/docs/content/en/hosting-and-deployment/hosting-on-render.md b/docs/content/en/hosting-and-deployment/hosting-on-render.md index 7a77742e2..73b20bcb2 100644 --- a/docs/content/en/hosting-and-deployment/hosting-on-render.md +++ b/docs/content/en/hosting-and-deployment/hosting-on-render.md @@ -4,7 +4,6 @@ linktitle: Host on Render description: Host your Hugo site for free with Render's global CDN, fully-managed SSL and auto deploys from GitHub. date: 2019-06-06 publishdate: 2019-06-06 -lastmod: 2020-01-01 categories: [hosting and deployment] keywords: [hosting,deployment] authors: [Anurag Goel] @@ -88,5 +87,4 @@ Render automatically downloads all Git submodules defined in your Git repo on ev Chat with Render developers at https://render.com/chat or email `[email protected]` if you need help. - [Quick Start]: /getting-started/quick-start/ |