gruntwork io.github.io

Site Gruntwork.io

Este é o código do site Gruntwork.

O Gruntwork pode ajudá -lo a obter toda a sua infraestrutura, definida como código, em cerca de um dia. Você se concentra no seu produto. Vamos cuidar do grunhido.

Docker Iniciar rápido

A maneira mais rápida de lançar este site é usar o Docker.

1. git clone este repo
2. docker compose up
3. Vá para http://localhost:4000 para testar
4. Se você estiver testando o fluxo de checkout, faça o login para abertura em: https://aperture.dogfood-stage.com/.

A configuração padrão do Docker Compõe suporta reloadia a quente do seu ambiente local, o que significa que, ao editar arquivos para alterar a marcação, o texto, as imagens, etc., seu servidor de desenvolvimento local captará essas alterações e recarregará a versão mais recente do site para você. Isso torna rápido e conveniente desenvolver no site localmente.

Início rápido manual

1. git clone este repo
2. Instale Jekyll
3. Apenas a primeira vez: bundle install
4. Start Jekyll Server: bundle exec jekyll serve --livereload
5. Vá para http://localhost:4000
6. Se você estiver testando o fluxo de checkout, faça o login para abertura em: https://aperture.dogfood-stage.com/.

Implantando

Para implantar o site:

1. Crie um PR com o seu código Alterações
2. Depois que o PR foi aprovado, mescla -o em master
3. Crie uma nova tag, você pode fazer isso manualmente via git ou na etapa subsequente na página de lançamentos - certifique -se de incrementar o número da versão usando versão semântica
4. Vá para a página de lançamentos e crie um rascunho de liberação com as informações relevantes (use o botão "Gereate Notas de lançamento" para facilitar sua vida)
5. Libere
6. O pipeline CI/CD o implantará automaticamente

Tecnologias

1. Construído com Jekyll. Este site é completamente estático e usamos HTML ou Markdown básico para tudo.
2. Os ambientes de visualização são construídos com o Netlify.
3. Hospedado no Amazon S3, com o CloudFront como um CDN. Usando S3_Website para fazer upload automaticamente de conteúdo estático para S3.
4. Usamos o bootstrap e menos.
5. Estamos usando o UpTimeRobot, o Google Analytics e o HubSpot Traffic Analytics para monitoramento e métricas.

Solução de problemas

Desativando a jóia de alimentação Jekyll

O site Gruntwork usa uma jóia Ruby chamada Jekyll Feed , que gera um feed RSS estruturado de "postagens" no site. Infelizmente, no desenvolvimento, isso pode desacelerar significativamente a realização a quente do site, forçando você a esperar mais de um minuto de cada vez para ver pequenas mudanças de texto localmente.

Você saberá que isso está acontecendo quando olhar para o STDOUT do seu processo docker-compose e a contagem final de segundos gastos Generating feed for posts é maior que 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.

Como uma solução alternativa temporária, você pode abrir o Gemfile na raiz do diretório do projeto e comentar temporariamente a linha que puxa a dependência de Jekyll Feed:

 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

IMPORTANTE - Certifique -se de que você não acaba cometendo essa alteração, porque queremos que o plugin Jekyll Feed seja executado para produção!

Fiz mudanças localmente, mas eles não estão refletindo no meu ambiente de desenvolvimento relowado a quente

Isso pode acontecer especialmente se você adicionar ou remover arquivos do diretório de trabalho do site. Quando isso ocorrer, encerre o processo do docker-compose e reinicie-o para ver suas alterações refletidas.

Licença

Veja License.txt.