在 Render 上托管

使用这些说明从 GitHub 仓库启用持续部署。如果您使用 Bitbucket 或 GitLab 进行版本控制，适用相同的一般步骤。

前提条件

请在继续之前完成以下任务：

1. 创建 Render 账户
2. 登录 您的 Render 账户
3. 创建 GitHub 账户
4. 登录 您的 GitHub 账户
5. 创建 项目的 GitHub 仓库
6. 创建 项目的本地 Git 仓库，并带有指向 GitHub 仓库的 远程 引用
7. 在本地 Git 仓库中创建 Hugo 网站，并使用 hugo server 命令测试

步骤

步骤 1

在项目根目录创建 Render Blueprint。

render.yaml

services:
  - type: web
    name: hosting-render
    repo: https://github.com/jmooring/hosting-render
    runtime: static
    buildCommand: chmod a+x build.sh && ./build.sh
    staticPublishPath: public
    envVars:
      - key: DART_SASS_VERSION
        value: 1.97.3
      - key: GO_VERSION
        value: 1.25.6
      - key: HUGO_VERSION
        value: 0.155.3
      - key: NODE_VERSION
        value: 24.13.0
      - key: TZ
        value: Europe/Oslo

步骤 2

在项目根目录创建 build.sh 文件。

build.sh

#!/usr/bin/env bash

#------------------------------------------------------------------------------
# @file
# 构建托管在 Render 上的 Hugo 网站。
#
# Render 会自动安装 Node.js 依赖。
#------------------------------------------------------------------------------

main() {

  # 为用户特定的可执行文件创建目录
  echo "Creating directory for user-specific executable files..."
  mkdir -p "${HOME}/.local"

  # 安装 Dart Sass
  echo "Installing Dart Sass ${DART_SASS_VERSION}..."
  curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz"
  export PATH="${HOME}/.local/dart-sass:${PATH}"

  # 安装 Go
  echo "Installing Go ${GO_VERSION}..."
  curl -sLJO "https://go.dev/dl/go${GO_VERSION}.linux-amd64.tar.gz"
  tar -C "${HOME}/.local" -xf "go${GO_VERSION}.linux-amd64.tar.gz"
  rm "go${GO_VERSION}.linux-amd64.tar.gz"
  export PATH="${HOME}/.local/go/bin:${PATH}"

  # 安装 Hugo
  echo "Installing Hugo ${HUGO_VERSION}..."
  curl -sLJO "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  mkdir -p "${HOME}/.local/hugo"
  tar -C "${HOME}/.local/hugo" -xf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  rm "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
  export PATH="${HOME}/.local/hugo:${PATH}"

  # 验证安装
  echo "Verifying installations..."
  echo Dart Sass: "$(sass --version)"
  echo Go: "$(go version)"
  echo Hugo: "$(hugo version)"
  echo Node.js: "$(node --version)"

  # 配置 Git
  echo "Configuring Git..."
  git config core.quotepath false
  if [ "$(git rev-parse --is-shallow-repository)" = "true" ]; then
    git fetch --unshallow
  fi

  # 构建网站
  echo "Building the site..."
  hugo --gc --minify --baseURL "${RENDER_EXTERNAL_URL}"

}

set -euo pipefail
main "$@"

步骤 3

将更改提交到本地 Git 仓库并推送到 GitHub 仓库。

步骤 4

在 Render [仪表板][]，按 Add new 按钮并从下拉菜单中选择"Blueprint"。

步骤 5

按 GitHub 按钮连接到您的 GitHub 账户。

步骤 6

按 Authorize Render 按钮允许 Render 应用程序访问您的 GitHub 账户。

步骤 7

选择您要安装 Render 应用程序的 GitHub 账户。

步骤 8

授权 Render 应用程序访问所有仓库或仅选择仓库，然后按 Install 按钮。

步骤 9

在"Create a new Blueprint Instance in My Workspace"页面，按 GitHub 仓库名称右侧的 Connect 按钮。

步骤 10

输入 Blueprint 的唯一名称，然后按页面底部的 Deploy Blueprint 按钮。

步骤 11

等待网站构建和部署完成，然后点击页面左侧的"Resources"链接。

步骤 12

点击静态网站资源的链接。

步骤 13

点击指向您已发布网站的链接。

将来，每当您从本地 Git 仓库推送更改时，Render 将重新构建和部署您的网站。