mirror
/
hugo
mirror of https://github.com/gohugoio/hugo
1
0
Fork 0
Code Issues
hugo/docs/content/en/hosting-and-deployment/hosting-on-aws-amplify/index.md

4.4 KiB
Raw Permalink Blame History

title description categories keywords menu toc
Host on AWS Amplify Host your site on AWS Amplify with continuous deployment.
hosting and deployment
hosting
docs
parent
hosting-and-deployment
true

Prerequisites

Please complete the following tasks before continuing:

  1. Create an AWS account
  2. Install Git
  3. Create a Hugo site and test it locally with hugo server
  4. Commit the changes to your local repository
  5. Push the local repository to your GitHub, GitLab, or Bitbucket account

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
Create a file named amplify.yml in the root of your project.
touch amplify.yml
Step 2
Copy and paste the YAML below into the file you created. Change the application versions and time zone as needed.

{{< code file=amplify.yml copy=true >}} version: 1 env: variables: # Application versions DART_SASS_VERSION: 1.81.0 GO_VERSION: 1.23.3 HUGO_VERSION: 0.139.3 # Time zone TZ: America/Los_Angeles # Cache HUGO_CACHEDIR: ${PWD}/.hugo NPM_CONFIG_CACHE: ${PWD}/.npm frontend: phases: preBuild: commands: # Install Dart Sass - curl -LJO https://github.com/sass/dart-sass/releases/download/{DART_SASS_VERSION}/dart-sass-{DART_SASS_VERSION}-linux-x64.tar.gz - sudo tar -C /usr/local/bin -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz - rm dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz - export PATH=/usr/local/bin/dart-sass:$PATH

    # Install Go
    - curl -LJO https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz
    - sudo tar -C /usr/local -xf go${GO_VERSION}.linux-amd64.tar.gz
    - rm go${GO_VERSION}.linux-amd64.tar.gz
    - export PATH=/usr/local/go/bin:$PATH

    # Install Hugo
    - curl -LJO https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz
    - sudo tar -C /usr/local/bin -xf hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz
    - rm hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz
    - export PATH=/usr/local/bin:$PATH

    # Check installed versions
    - go version
    - hugo version
    - node -v
    - npm -v
    - sass --embedded --version

    # Install Node.JS dependencies
    - "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci --prefer-offline || true"

    # https://github.com/gohugoio/hugo/issues/9810
    - git config --add core.quotepath false
build:
  commands:
    - hugo --gc --minify

artifacts: baseDirectory: public files: - '/*' cache: paths: - ${HUGO_CACHEDIR}//* - ${NPM_CONFIG_CACHE}/**/* {{< /code >}}

Step 3
Commit and push the change to your GitHub repository.
git add -A
git commit -m "Create amplify.yml"
git push
Step 4
Log in to your AWS account, navigate to the Amplify Console, then press the Deploy an app button.
Step 5
Choose a source code provider, then press the Next button.

screen capture

Step 6
Authorize AWS Amplify to access your GitHub account.

screen capture

Step 7
Select your personal account or relevant organization.

screen capture

Step 8
Authorize access to one or more repositories.

screen capture

Step 9
Select a repository and branch, then press the Next button.

screen capture

Step 10
On the "App settings" page, scroll to the bottom then press the Next button. Amplify reads the amplify.yml file you created in Steps 1-3 instead of using the values on this page.
Step 11
On the "Review" page, scroll to the bottom then press the Save and deploy button.
Step 12
When your site has finished deploying, press the Visit deployed URL button to view your published site.

screen capture