gruntwork io.github.io

gruntwork.ioのウェブサイト

これは、Gruntwork Webサイトのコードです。

Gruntworkは、約1日でコードとして定義されたインフラストラクチャ全体を取得するのに役立ちます。あなたはあなたの製品に焦点を合わせます。うなり声の世話をします。

Dockerクイックスタート

このサイトを起動する最速の方法は、Dockerを使用することです。

1. git clone
2. docker compose up
3. http://localhost:4000にアクセスしてテストします
4. チェックアウトフローをテストする場合は、https：//aperture.dogfood-stage.com/でapertureにログインする必要があります。

デフォルトのDocker Compose Configurationは、ローカル環境のホットレロードをサポートします。つまり、ファイルを編集してマークアップ、テキスト、画像などを変更すると、ローカル開発サーバーがこれらの変更をピックアップし、サイトの最新バージョンをリロードします。これにより、サイトでローカルに開発するのが迅速かつ便利になります。

手動のクイックスタート

1. git clone
2. Jekyllをインストールします
3. 初めて： bundle install
4. Jekyll Serverを開始： bundle exec jekyll serve --livereload
5. http://localhost:4000にアクセスしてください
6. チェックアウトフローをテストする場合は、https：//aperture.dogfood-stage.com/でapertureにログインする必要があります。

展開

サイトを展開するには：

1. コードが変更された状態でPRを作成します
2. PRが承認された後、それをmasterにマージします
3. 新しいタグを作成すると、Gitを介してこれを手動で行うか、リリースページの後続のステップで実行できます。
4. リリースページに移動して、関連情報を使用してドラフトリリースを作成します（「リリースノートの生成」ボタンを使用して、ライフを簡単にします）
5. それをリリースします
6. CI/CDパイプラインは自動的に展開します

テクノロジー

1. ジキルと一緒に建てられました。このWebサイトは完全に静的であり、すべてに基本的なHTMLまたはマークダウンを使用しています。
2. プレビュー環境は、netlifyで構築されています。
3. Amazon S3でホストされ、CloudFrontはCDNとして。 S3_Websiteを使用して、静的コンテンツをS3に自動的にアップロードします。
4. Bootstrap以上を使用しています。
5. 監視とメトリックのために、Uptimerobot、Google Analytics、およびHubspot Traffic Analyticsを使用しています。

トラブルシューティング

ジキルフィードジェムを無効にします

GruntworkのWebサイトではJekyll Feedと呼ばれるRuby Gemを使用して、サイト上の「投稿」の構造化されたRSSフィードを生成します。残念ながら、開発では、これはサイトのホットレロードを大幅に遅くすることができ、マイナーなテキストがローカルに変化するのを見るために、一度に1分以上待つことを余儀なくされます。

docker-composeプロセスのSTDOUTを見ると、これが起こっていることがわかり、 Generating feed for posts費やされた秒の最終カウントは5を超えています。

 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.

一時的な回避策として、プロジェクトディレクトリのルートでGemfileを開き、Jekyllフィード依存関係を引き出すラインを一時的にコメントすることができます。

 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

重要- Jekyll Feedプラグインを生産のために実行したいので、この変更をコミットしないことを確認してください！

私はローカルで変更を加えましたが、彼らは私のホットなロレッド開発環境に反映されていません

これは、特にWebサイトのワーキングディレクトリからファイルを追加または削除する場合に発生する可能性があります。これが発生したら、 docker-composeプロセスを終了し、再起動して変更が反映されます。

ライセンス

license.txtを参照してください。