hugo deploy

Hugo Deploy

Dies ist ein Ausgangspunkt für einen Hugo-Blog mit Bereitstellung auf Amazon S3 über GitHub Actions.

So stelle ich nathany.com, Edmonton Go und fsnotify.org bereit.

Anforderungen

Lokale Entwicklung:

• Installieren Sie die hugo -Binärdatei und laden Sie sie unter gohugo.io herunter.
  • Verwenden Sie auf dem Mac Homebrew: brew install hugo

Fernbedienung:

• Ein GitHub-Konto mit den Inhalten Ihrer Website (kostenlos).
• Ein Amazon-Konto zum Erstellen eines S3-Buckets (Pennies).
• DNS ist so konfiguriert, dass es auf S3 verweist.
  • CloudFlare wird für HTTPS empfohlen (kostenlos).

Was wird bereitgestellt?

• hugo new site <mysite> erstellt eine config.toml und ein paar leere Ordner. Ich habe .gitkeep-Dateien hinzugefügt, damit diese Ordner eingecheckt werden.
• Ein assets/sass -Ordner mit all.sass , der in CSS konvertiert wird.
• Ein Skript, das bei der Entwicklung auf Dateiänderungen achtet und Entwürfe in die Ausgabe einbezieht. Führen Sie ./watch.sh aus.
• .gitignore , um ein Commit der generierten Dateien zu vermeiden.
• Workflow-Datei, die GitHub Actions für die Bereitstellung verwendet ( .github/workflows/build.yml ).

Einsatz

GitHub-Aktionen stellen die Website automatisch bereit, wenn Änderungen im Master-Zweig auf GitHub zusammengeführt werden. Meiner Erfahrung nach dauert die Bereitstellung einige Sekunden.

• „hugo-deploy-example.s3-website.ca-central-1.amazonaws.com“ ist der Website-Endpunkt auf Amazon S3.

Diese Bucket-Richtlinie bietet öffentlichen Zugriff auf die Dateien in S3.

 {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "PublicReadGetObject",
            "Effect": "Allow",
            "Principal": "*",
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::hugo-deploy-example/*"
            ]
        }
    ]
}