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 الافتراضي تكوين التكوين الساخن لبيئتك المحلية ، مما يعني أنه عند تحرير الملفات لتغيير العلامات والنصوص والصور ، إلخ ، سيقوم خادم التطوير المحلي بتقاط هذه التغييرات وإعادة تحميل أحدث إصدار من الموقع لك. هذا يجعله سريعًا ومريحًا للتطوير على الموقع محليًا.

بداية سريعة يدوي

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. قم بإنشاء PR مع تغييرات الكود الخاصة بك
2. بعد الموافقة على العلاقات العامة ، قم بدمجها في master
3. إنشاء علامة جديدة ، يمكنك القيام بذلك يدويًا عبر GIT أو في الخطوة اللاحقة على صفحة الإصدارات - تأكد من زيادة رقم الإصدار باستخدام الإصدار الدلالي
4. انتقل إلى صفحة الإصدارات وإنشاء مسودة إصدار مع المعلومات ذات الصلة (استخدم زر "إنشاء ملاحظات الإصدار" لتسهيل حياتك)
5. الافراج عنه
6. سيتم نشر خط أنابيب CI/CD تلقائيًا

التقنيات

1. بنيت مع jekyll. هذا الموقع ثابت تمامًا ونحن نستخدم HTML الأساسي أو التخفيض لكل شيء.
2. تم تصميم بيئات المعاينة مع NetLify.
3. استضافت على Amazon S3 ، مع Cloudfront كـ CDN. باستخدام S3_Website لتحميل المحتوى الثابت تلقائيًا إلى S3.
4. نحن نستخدم bootstrap وأقل.
5. نحن نستخدم UpTimerObot و Google Analytics و HubSpot Association Analytics للمراقبة والمقاييس.

استكشاف الأخطاء وإصلاحها

تعطيل جوهرة التغذية jekyll

يستخدم موقع Gruntwork Gem Gem يسمى 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 للإنتاج!

لقد قمت بإجراء تغييرات محليًا لكنهم لا ينعكسون في بيئة التنمية التي تم تحميلها الساخنة

يمكن أن يحدث هذا خاصة إذا قمت بإضافة أو إزالة الملفات من دليل عمل موقع الويب. عند حدوث ذلك ، قم بإنهاء عملية docker-compose وإعادة تشغيلها لرؤية تغييراتك تنعكس.

رخصة

انظر الترخيص.