gruntwork io.github.io

Gruntwork.io Веб -сайт

Это код для веб -сайта Gruntwork.

Gruntwork может помочь вам получить всю вашу инфраструктуру, определенную как код, примерно за день. Вы сосредотачиваетесь на своем продукте. Мы позаботимся о хрустящей работе.

Docker Quick Start

Самый быстрый способ запустить этот сайт - использовать Docker.

1. git clone это репо
2. docker compose up
3. Перейти к http://localhost:4000 чтобы проверить
4. Если вы собираетесь тестировать поток оформления кассы, вы должны войти в систему, чтобы аффировать по адресу: https://aperture.dogfood-stage.com/.

Конфигурация Docker Docker по умолчанию поддерживает горячую переоценку вашей локальной среды, что означает, что при редактировании файлов для изменения разметки, текста, изображений и т. Д. Ваш локальный сервер разработки заберут эти изменения и перезагружает последнюю версию сайта для вас. Это делает его быстрым и удобным для развития на сайте локально.

Ручной быстрый старт

1. git clone это репо
2. Установите Jekyll
3. Только в первый раз: bundle install
4. Start Jekyll Server: bundle exec jekyll serve --livereload
5. Перейдите в http://localhost:4000
6. Если вы собираетесь тестировать поток оформления кассы, вы должны войти в систему, чтобы аффировать по адресу: https://aperture.dogfood-stage.com/.

Развертывание

Для развертывания сайта:

1. Создайте пиар с изменением кода
2. После того, как PR был утвержден, объедините его в master
3. Создайте новый тег, вы можете сделать это вручную через GIT или на последующем шаге на странице выпусков - обязательно увеличите номер версии, используя семантическое управление версиями
4. Перейдите на страницу релизов и создайте проект релиза с соответствующей информацией (используйте кнопку «Generate Release Notes», чтобы облегчить вашу жизнь)
5. Выпустить это
6. Трубопровод CI/CD будет развернуть его автоматически

Технологии

1. Построен с Джекиллом. Этот веб -сайт полностью статичен, и мы используем базовый HTML или Marckdown для всего.
2. Предварительные среды построены с NetLify.
3. Расположенный на Amazon S3, с Cloudfront в качестве CDN. Использование s3_website для автоматической загрузки статического контента в S3.
4. Мы используем начальную загрузку и меньше.
5. Мы используем UptimeroBot, Google Analytics и HubSpot Traffic Analytics для мониторинга и метрик.

Поиск неисправностей

Отключение драгоценного камня Jekyll Feed

На сайте Gruntwork используется рубиновый драгоценный камень под названием Jekyll Feed , который генерирует структурированный RSS -канал «сообщений» на сайте. К сожалению, в разработке это может значительно замедлить горячую переработку сайта, заставив вас ждать минуты за минуту, чтобы увидеть незначительные изменения текста на местном уровне.

Вы будете знать, что это происходит, когда вы посмотрите на STDOUT вашего процесса docker-compose , и окончательный счет, проведенный 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 работал за производство!

Я внес изменения локально, но они не отражаются в моей горячей загруженной среде разработки

Это может произойти, особенно если вы добавляете или удаляете файлы из рабочего каталога веб -сайта. Когда это происходит, прекратите процесс docker-compose и перезапустите его, чтобы увидеть, как ваши изменения отражаются.

Лицензия

См. License.txt.