gruntwork io.github.io

grunnwork.io Website

Dies ist der Code für die Gruntwork -Website.

Grunzwerk kann Ihnen dabei helfen, Ihre gesamte Infrastruktur, die in etwa einem Tag als Code definiert ist, zu erhalten. Sie konzentrieren sich auf Ihr Produkt. Wir werden uns um das Grunzwerk kümmern.

Docker schneller Start

Der schnellste Weg, um diese Website zu starten, besteht darin, Docker zu verwenden.

1. git clone dieses Repo
2. docker compose up
3. Gehen Sie zu http://localhost:4000 um zu testen
4. Wenn Sie den Checkout-Fluss testen möchten, müssen Sie sich bei Blace unter: https://aperture.dogfood-stage.com/ anmelden.

Die Standard-Docker-Komponierungskonfiguration unterstützt die Hot-Relading Ihrer lokalen Umgebung. Wenn Sie Dateien zum Ändern von Markup, Text, Bildern usw. bearbeiten, nimmt Ihr lokaler Entwicklungsserver diese Änderungen auf und laden Sie die neueste Version der Website für Sie neu. Dies macht es schnell und bequem, sich lokal auf der Website zu entwickeln.

Manuell schneller Start

1. git clone dieses Repo
2. Installieren Sie Jekyll
3. Nur beim ersten Mal: bundle install
4. Starten Sie Jekyll Server: bundle exec jekyll serve --livereload
5. Gehen Sie zu http://localhost:4000
6. Wenn Sie den Checkout-Fluss testen möchten, müssen Sie sich bei Blace unter: https://aperture.dogfood-stage.com/ anmelden.

Bereitstellung

So bereitstellen Sie die Website:

1. Erstellen Sie eine PR mit Ihren Codeänderungen
2. Nachdem die PR genehmigt wurde, fusionieren Sie sie in master
3. Erstellen Sie ein neu
4. Gehen Sie zur Seite "Releases" und erstellen Sie einen Entwurf mit den relevanten Informationen (verwenden Sie die Schaltfläche "Veröffentlichungsnotizen generieren", um Ihr Leben zu erleichtern).
5. Loslassen
6. In der CI/CD -Pipeline werden sie automatisch bereitgestellt

Technologien

1. Gebaut mit Jekyll. Diese Website ist völlig statisch und wir verwenden grundlegende HTML oder Markdown für alles.
2. Vorschau -Umgebungen werden mit Netlify erstellt.
3. Hosted bei Amazon S3 mit Cloudfront als CDN. Verwenden von S3_Website, um statische Inhalte automatisch auf S3 hochzuladen.
4. Wir verwenden Bootstrap und weniger.
5. Wir verwenden UPTIMEROBOT-, Google Analytics- und HubSpot -Verkehrsanalyse für Überwachung und Metriken.

Fehlerbehebung

Deaktivieren des Jekyll Feed Edelsteins

Auf der Gruntwork -Website werden ein Ruby -Edelstein namens Jekyll Feed verwendet, das auf der Website einen strukturierten RSS -Feed von "Posts" erzeugt. Leider kann dies in der Entwicklung die heiße Relader des Standorts erheblich verlangsamen und Sie zwingen, jeweils über eine Minute zu warten, um geringfügige Textänderungen vor Ort zu sehen.

Sie werden wissen, dass dies geschieht, wenn Sie sich die STDOUT Ihres docker-compose -Prozesses ansehen, und die endgültige Anzahl von Sekunden, die für Generating feed for posts mehr als 5 sind:

 web_1  |       Regenerating: 1 file(s) changed at 2021-07-21 14:31:08
web_1  |                     _data/website-terms.yml
web_1  |        Jekyll Feed: Generating feed for posts
web_1  |                     ...done in 58.507850014 seconds.

Als vorübergehende Problemumgehung können Sie die GemFile in der Wurzel des Projektverzeichnisses öffnen und die Zeile, die die Jekyll -Feed -Abhängigkeit einzieht, vorübergehend ausgeben:

 source 'https://rubygems.org'
gem 'jekyll', '~> 4.1'
gem 's3_website', '3.3.0'
group :jekyll_plugins do
  gem 'jekyll-redirect-from', '0.16.0'
  gem 'jekyll-sitemap', '1.4.0'
  gem 'jekyll-paginate', '1.1.0'
  gem 'therubyracer', '0.12.3'
  gem 'less', '2.6.0'
  gem 'jekyll-asciidoc'
  gem 'jekyll-toc'
  gem 'nokogiri', '1.11.0.rc4' # Addressing security issue in earlier versions of this library
#  gem 'jekyll-feed'
end

Wichtig - stellen Sie sicher, dass Sie diese Änderung nicht begehen, da das Jekyll Feed -Plugin für die Produktion ausgeführt wird!

Ich habe Änderungen vor Ort vorgenommen, aber sie spiegeln sich nicht in meiner mit heiß geradenen Entwicklungsumgebung wider

Dies kann insbesondere dann geschehen, wenn Sie Dateien aus dem Arbeitsverzeichnis der Website hinzufügen oder entfernen. In diesem Fall beenden Sie Ihren docker-compose -Prozess und starten Sie ihn neu, um Ihre Änderungen zu erkennen.

Lizenz

Siehe Lizenz.TXT.