• DigitalOcean-account

Dockerbestand maken

Maak de Dockerfile aan in de hoofdmap van uw site.

Onze starter sjabloon bevat al de Dockerfile.

 1###############
 2# Build Stage #
 3###############
 4FROM hugomods/hugo:exts as builder
 5
 6COPY . /src
 7
 8ENV HUGO_ENV=production
 9
10# Base URL
11ARG HUGO_BASEURL=
12ENV HUGO_BASEURL=${HUGO_BASEURL}
13
14# Module Proxy
15ARG HUGO_MODULE_PROXY=
16ENV HUGO_MODULE_PROXY=${HUGO_MODULE_PROXY}
17
18# NPM mirrors, such as https://registry.npmmirror.com
19ARG NPM_CONFIG_REGISTRY=
20ENV NPM_CONFIG_REGISTRY=${NPM_CONFIG_REGISTRY}
21
22# Install dependencies
23RUN npm ci
24
25# Build site
26RUN hugo --minify --gc --enableGitInfo
27
28# Set the fallback 404 page if defaultContentLanguageInSubdir is enabled, please replace the `en` with your default language code.
29# RUN cp ./public/en/404.html ./public/404.html
30
31###############
32# Final Stage #
33###############
34FROM hugomods/hugo:nginx
35COPY --from=builder /src/public /site

• De /site is de uitvoermap van statische bestanden, die later zal worden gebruikt.

App maken

Navigeer naar DigitalOcean Dashboard -> Left Panel -> Apps -> Create App en vul het formulier als volgt in.

Werkstroom

Maak .gitlab-ci.yml aan in de hoofdmap van uw site met de volgende inhoud:

 1image: registry.gitlab.com/pages/hugo/hugo_extended:latest
 2
 3variables:
 4  HUGO_ENV: production
 5
 6default:
 7  before_script:
 8    - apk add --update --no-cache git go npm
 9    - npm install
10
11test:
12  script:
13    - hugo --gc --minify
14  rules:
15    - if: $CI_COMMIT_REF_NAME != $CI_DEFAULT_BRANCH
16
17pages:
18  script:
19    - hugo --gc --minify
20  artifacts:
21    paths:
22      - public
23  rules:
24    - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH

Het bovenstaande voorbeeld implementeert alleen de standaardvertakking naar GitLab Pages en voert een test uit op de rest van de vertakkingen.

Bouwhulpmiddelen

Zoals Vereisten al zei, moet u deze tools instellen in uw implementatieomgeving.

Afhankelijkheden installeren

We gebruiken NPM voor het beheren van de afhankelijkheden van het thema. Het is noodzakelijk om de afhankelijkheden in de implementatieomgeving te installeren, omdat we MOET NIET de map node_modules vastleggen.

Principe

1. Gebruik Hugo om de site te bouwen en statische bestanden te genereren.
2. Gebruik Nginx als server om verzoeken af ​​te handelen.

Dockerbestand

Maak een Dockerfile in de hoofdmap van de site.

 1###############
 2# Build Stage #
 3###############
 4FROM razonyang/hugo as builder
 5
 6WORKDIR /src
 7COPY . /src
 8
 9ARG HUGO_ENV=production
10ENV HUGO_ENV=${HUGO_ENV}
11
12# Base URL
13ARG HUGO_BASEURL=/
14ENV HUGO_BASEURL=${HUGO_BASEURL}
15
16# Module Proxy
17ARG HUGO_MODULE_PROXY=
18ENV HUGO_MODULE_PROXY=${HUGO_MODULE_PROXY}
19
20# NPM mirrors, such as https://registry.npmmirror.com
21ARG NPM_CONFIG_REGISTRY=
22ENV NPM_CONFIG_REGISTRY=${NPM_CONFIG_REGISTRY}
23
24# Install dependencies
25RUN npm install
26RUN npm install -g @fullhuman/postcss-purgecss rtlcss
27
28# Build site
29RUN hugo --minify --gc --enableGitInfo
30
31# Set the fallback 404 page if defaultContentLanguageInSubdir is enabled, please replace the `en` with your default language code.
32# RUN cp ./public/en/404.html ./public/404.html
33
34###############
35# Final Stage #
36###############
37FROM nginx
38COPY --from=builder /src/public /app
39COPY deploy/nginx/default.conf /etc/nginx/conf.d/default.conf

• Er zijn twee fasen in de build: een build-fase en een release-fase. De releasefase bevat alleen de gegenereerde statische bestanden, waardoor de grootte van de Docker-image zo klein mogelijk blijft.
• Als u defaultContentLanguageInSubdir heeft ingeschakeld, verwijder dan de opmerkingen en wijzig deze indien nodig.
• De parameter HUGO_BASEURL wordt gebruikt om de baseURL van de site op te geven tijdens het bouwen, en wordt over het algemeen gebruikt wanneer de baseURL afwijkt van de configuratie, dus u kunt deze zelf verwijderen als u deze niet nodig heeft.
• HUGO_MODULE_PROXY en NPM_CONFIG_REGISTRY zijn optionele buildparameters die kunnen worden verwijderd als ze niet nodig zijn.

Nginx

Maak een deploy/nginx/default.conf in de hoofdmap van de site:

Werkstroom

Maak .github/workflows/gh-pages.yml aan in de hoofdmap van de site.

 1name: GitHub Pages
 2on:
 3  push:
 4    branches:
 5      - main
 6permissions:
 7  contents: write
 8jobs:
 9  build-and-deploy:
10    concurrency: ci-${{ github.ref }}
11    runs-on: ubuntu-latest
12    steps:
13      - name: Checkout 🛎️
14        uses: actions/checkout@v3
15        with:
16          submodules: true
17          fetch-depth: 0
18
19      - name: Setup Node
20        uses: actions/setup-node@v3
21        with:
22          node-version: '16'
23
24      - name: Cache dependencies
25        uses: actions/cache@v2
26        with:
27          path: ~/.npm
28          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
29          restore-keys: |
30            ${{ runner.os }}-node-            
31
32      - name: Install dependencies
33        run: npm install
34
35      - name: Setup Hugo
36        uses: peaceiris/actions-hugo@v2
37        with:
38          hugo-version: 'latest'
39          extended: true
40
41      - name: Build
42        run: hugo --minify --gc --enableGitInfo
43
44      - name: Deploy 🚀
45        uses: peaceiris/actions-gh-pages@v3
46        with:
47          github_token: ${{ secrets.GITHUB_TOKEN }}
48          publish_dir: ./public

Zie ook Starterssjabloon GitHub-pagina’s Workflow。

]]>https://1552afcb.notes-6if.pages.dev/docs/deployment/cloudflare-pages/Tue, 12 Jul 2022 20:06:24 +0800https://1552afcb.notes-6if.pages.dev/docs/deployment/cloudflare-pages/In dit artikel wordt uitgelegd hoe u uw site kunt implementeren op Cloudflare-pagina’s.

Een project maken

We beginnen met het maken van een Git-project en het invullen van de juiste informatie.

Bouwopdracht

1npm i && hugo --gc --minify --enableGitInfo -b https://hbs-skeleton.pages.dev

1. npm i is een snelkoppeling naar npm install, waarmee de afhankelijkheden worden geïnstalleerd die worden gebruikt tijdens het bouwen van de site.
2. -b https://hbs-skeleton.pages.dev specificeert baseURL, vervang dit alstublieft zelf. U kunt het ook opslaan in een configuratiebestand in plaats van het op te geven in de build-opdracht.

Omgevingsvariabelen

Naam	Waarde
HUGO_VERSION	0.147.9
NODE_VERSION	16

404 Pagina

Cloudflare is slim genoeg om de best passende 404-pagina’s te gebruiken, zelfs voor meertalige sites, en werkt zonder aanvullende configuraties.

]]>https://1552afcb.notes-6if.pages.dev/docs/deployment/netlify/Tue, 12 Jul 2022 14:20:49 +0800https://1552afcb.notes-6if.pages.dev/docs/deployment/netlify/Dit artikel laat zien hoe u uw site kunt implementeren op Netlificeren.

Netlify-configuratie

Maak een netlify.toml in de hoofdmap van de site:

 1[build]
 2  publish = "public"
 3
 4[build.environment]
 5  NODE_VERSION = "17.6.0"
 6  HUGO_VERSION = "0.147.9"
 7  HUGO_ENABLEGITINFO = "true"
 8  GO_VERSION = "1.17.7"
 9
10[context.production]
11  command = "npm install && hugo --minify"
12
13[context.production.environment]
14  HUGO_ENV = "production"
15
16[[headers]]
17  for = "/*"
18  [headers.values]
19    Referrer-Policy = "strict-origin-when-cross-origin"
20    X-Content-Type-Options = "nosniff"
21    X-Frame-Options = "deny"
22    X-XSS-Protection = "1; mode=block"
23
24[[redirects]]
25  from = "/:lang/*"
26  to = "/:lang/404.html"
27  status = 404
28
29[[redirects]]
30  from = "/*"
31  to = "/en/404.html" # Replace the "en" to your default language code if "defaultContentLanguageInSubdir" is enabled, otherwise use "/404.html" instead.
32  status = 404

Zie ook Starterssjabloon Netlify-configuratie.

]]>