ghpages

إجراء GitHub لنشر الأصول الثابتة على صفحات GitHub

لقد تم إهمال هذا الإجراء. يوجد الآن دعم "أصلي" للنشر على صفحات GitHub باستخدام إجراء GitHub الرسمي بواسطة GitHub. إنه أفضل بكثير من هذا النهج.

يتيح لك هذا الإجراء ببساطة نشر مجلدات عشوائية للمحتوى الثابت من دليل عمل سير العمل الخاص بك ( /github/workspace ) إلى صفحات GitHub. يعمل هذا من خلال قيام git push مجلد الأصول الذي اخترته ( BUILD_DIR ) إلى فرع gh-pages في مستودع GitHub الخاص بك ليتم تقديم فرع gh-pages . إذا كنت تقوم بتشغيل هذا الإجراء داخل مؤسسة أو مستودع مستخدم (يُسمى username/username.github.io ) فسيتم نشره في الفرع master بدلاً من ذلك.

تذكر أنه قد يتعين عليك أيضًا ضبط إعدادات المستودع الخاص بك.

نظرًا لأن هذا الإجراء يتم نشره في فروع منفصلة "للنشر فقط"، فلا يمكنك استخدامه إذا كنت تريد النشر من دليل فرعي للريبو مثل docs/ . في تلك الحالات، لا تحتاج حقًا إلى إجراء GitHub، لأنك ستلتزم بتنفيذ عناصر البناء بنفسك. لمزيد من التفاصيل، راجع وثائق صفحات جيثب.

توجد بالفعل إجراءات GitHub رائعة لاستخدام مولدات المواقع الثابتة ثم نشرها على صفحات GitHub (لـ jekyll وjekyll وzola وبالتأكيد الكثير في المستقبل). هذا الإجراء ليس كذلك، على الرغم من أنني استعرت الكثير من إجراءات git من هذه الأعمال.

لن يؤدي هذا الإجراء إلى بناء أي شيء، بل يتم نشره فقط.

المدخلات

لا أحد.

النواتج

لا أحد.

أسرار

يتم النشر على صفحات GitHub عن طريق git push ing إلى فرع gh-pages (أو master ). للسماح بذلك، يحتاج إجراء GitHub إلى سر. في الوقت الحالي، ومن المربك إلى حد ما، أن GITHUB_TOKEN المتوفر لكل الريبو يكفي للدفع إلى gh-pages ، لكنه لا يكفي لتحفيز إنشاء صفحة على GitHub، أو حتى نشر المحتوى إلى شبكة تسليم المحتوى GitHub.

لذلك يتعين عليك إنشاء رمز وصول شخصي (PAT) مخصص تمامًا مثلما تفعل مع الخدمات الخارجية (على سبيل المثال، ترافيس). يجب إنشاء هذا الرمز المميز بأذونات repo حتى يتم نشره على صفحات Github. يتعين عليك بعد ذلك لصق هذا الرمز المميز في واجهة مستخدم GitHub باعتباره سرًا تحت اسم GH_PAT (إعدادات/أسرار المستودع) واستدعائه في الإجراء كما هو موضح أدناه.

لقد طلبت من GitHub تبسيط هذه العملية. وقد تم توثيق المناقشة هنا.

متغيرات البيئة

فقط BUILD_DIR ، دليل البناء المتعلق بجذر المستودع الخاص بك. يمكنك أيضًا المرور . إذا كنت تريد دفع جذر المستودع الخاص بك.

مثال الاستخدام

 name : Deployment

" on " :
  - push
  - pull_request

jobs :
  deploy_ghpages :
    runs-on : ubuntu-18.04
    steps :
      - uses : actions/checkout@v1
      - run : echo $GITHUB_SHA >> public/index.html
      - uses : maxheld83/[email protected]
        env :
          BUILD_DIR : public/
          GH_PAT : ${{ secrets.GH_PAT }}