在 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 將重新構建和部署您的網站。