হাবরকে একটু ঘষে দেখে, আমি অবাক হয়েছিলাম যে GitHub-এর (বিটা) বৈশিষ্ট্য - অ্যাকশনের বিষয়ে খুব কম নিবন্ধ প্রকাশিত হয়েছে।

এটা মনে হয় যে এই ধরনের ছোটোখাটো ব্যাখ্যা করা যেতে পারে যে কার্যকারিতা এখনও পরীক্ষায় রয়েছে, যদিও "বিটা"। কিন্তু এটি বিটা এর একটি দরকারী বৈশিষ্ট্য যা এই টুলটিকে ব্যক্তিগত সংগ্রহস্থলে ব্যবহার করার অনুমতি দেয়। এটি এই প্রযুক্তির সাথে কাজ করার বিষয়ে যা আমি এই নিবন্ধে কথা বলব।

পূর্বইতিহাস

যদি আমরা ক্রমানুসারে শুরু করি, তবে সম্ভবত এটি উল্লেখ করার মতো যে একটি ব্যক্তিগত "আমার সম্পর্কে" ওয়েবসাইট সংরক্ষণের জন্য একটি দ্রুত, সুবিধাজনক, সহজ এবং বিনামূল্যের বিকল্প অনুসন্ধান করার প্রক্রিয়াতে, আমাকে বেশ কয়েকটি রাত কাটাতে হয়েছিল এবং অনেক নিবন্ধের মাধ্যমে চিরুনি দিতে হয়েছিল।

কিছু লোক হোস্টিং বেছে নেয়, অন্যরা ক্লাউড সার্ভার, এবং যারা এই সমস্ত কিছুর জন্য কাজ, মিথস্ক্রিয়া এবং অর্থপ্রদান বুঝতে চায় না যেমন একটি সংগ্রহস্থলে স্ট্যাটিক সাইট আপলোড করা, যেহেতু এখন এটি গিটহাব এবং গিটল্যাব উভয়েই করা যেতে পারে।

অবশ্যই, এটি প্রত্যেকের ব্যক্তিগত পছন্দ।

আমার চূড়ান্ত পছন্দ ছিল গিটহাব পেজ।

পেজ সম্পর্কে

কে জানে না gh-pages - এটি একটি ওয়েবসাইটের আকারে ডকুমেন্টেশন সংরক্ষণের জন্য একটি বিকল্প এবং এটি বিনামূল্যে প্রদান করা হয়, এবং ডকুমেন্টেশন ছাড়াও, এটি ব্যক্তিগত ওয়েবসাইটগুলি সংরক্ষণ করার প্রস্তাব করা হয়। এই কার্যকারিতা GitHub দ্বারা সমস্ত ব্যবহারকারীদের প্রদান করা হয় এবং সংগ্রহস্থল সেটিংসে উপলব্ধ।

প্রকল্প সংগ্রহস্থল একটি শাখা ব্যবহার করে gh-pages, একটি ব্যবহারকারী সাইটের জন্য - নামের সাথে একটি পৃথক সংগ্রহস্থল username.github.io সাইটের উত্স সহ master শাখা

আরও বিশদ দেখা যায় ডকুমেন্টেশনে, কিন্তু আমাকে শুধু মনে রাখবেন যে GitHub আশ্চর্যজনকভাবে উদার যে কাউকে কেবল একটি ফাইল যোগ করে এই ধরনের একটি সাইটে তাদের নিজস্ব ডোমেন লিঙ্ক করার অনুমতি দেয় CNAME ডোমেন নামের সাথে এবং GitHub সার্ভারে আপনার ডোমেন প্রদানকারীর DNS সেট আপ করুন।

আমি নিশ্চিত যে এই ধরনের একটি সাইট কীভাবে বিকাশ করা যায় সে সম্পর্কে এখানে অনেক নিবন্ধ রয়েছে, তাই আমি এই বিষয়ে আরও কথা বলতে যাচ্ছি না।

সমস্যা দেখা দেয়

সমস্যাটি ছিল যে একটি স্ট্যাটিক জেনারেটর ব্যবহার করার সময়, অতিরিক্ত স্ক্রিপ্টগুলি লিখতে এবং পৃষ্ঠাগুলি তৈরি করার এবং সেগুলিকে সংগ্রহস্থলে লোড করার প্রক্রিয়া সহজ করার জন্য লাইব্রেরি ব্যবহার করার প্রয়োজন ছিল। সহজভাবে, যদি আপনি একটি পৃথক ব্যক্তিগত সংগ্রহস্থলে উত্সগুলি সঞ্চয় করেন, তবে প্রতিবার সাইটে যে কোনও পরিবর্তন ঘটলে, মূল সাইটের সংগ্রহস্থলে পরবর্তী প্রজন্মের স্ট্যাটিক পৃষ্ঠা এবং প্রকাশনার জন্য স্থানীয় পরিবেশ স্থাপন করা প্রয়োজন ছিল।

প্রাচুর্য আছে স্ট্যাটিক জেনারেটর এবং তাদের সবার একই সমস্যা আছে। এই ক্রিয়াগুলি খুব বেশি সময় এবং প্রচেষ্টা নেয় এবং শেষ পর্যন্ত সাইটের কাজকে ধীর করে দেয়, বিশেষ করে OS থেকে OS-এ একাধিক স্থানান্তর বা হার্ড ড্রাইভে ডেটা হারানোর ঘটনার পরে (এটা আমার ক্ষেত্রে ছিল).

সম্প্রতি, হয় ওয়েবসাইটের একটি পপ-আপ বিজ্ঞপ্তিতে বা গিটহাবের একটি নিউজলেটারে, একটি নতুন নির্মিত CI/CD লক্ষ্য করা গেছে, যা এই ক্রিয়াকলাপগুলিকে ন্যূনতম প্রচেষ্টার সাথে সম্পন্ন করার অনুমতি দেয়৷

স্ট্যাটিক পেজ জেনারেটর সম্পর্কে

আমি এই উপ-আইটেমটির উপর বিশেষ মনোযোগ দেব না, তবে আমি কয়েকটি থিসিস শেয়ার করব যা আমি নিম্নলিখিত নির্বাচন এবং ব্যবহারের সময় এসেছি:

1) এমন একটি জেনারেটর চয়ন করুন যা আপনার প্রোগ্রামিং ভাষার উপযুক্ত, বা যতটা সম্ভব পরিষ্কার। আমি এমন একটি সময়ে এই ধারণাটি নিয়ে এসেছি যখন আমাকে সাইটে কাজ করার জন্য কিছু কার্যকারিতা যোগ করতে হয়েছিল, এর বৃহত্তর স্থিতিশীলতা এবং স্বয়ংক্রিয়তার জন্য ক্রাচ যোগ করতে হয়েছিল। উপরন্তু, প্লাগইন আকারে অতিরিক্ত কার্যকারিতা নিজেই লিখতে এটি একটি ভাল কারণ;

2) কোন জেনারেটরটি বেছে নেবেন তা একটি ব্যক্তিগত পছন্দ, তবে এটি বিবেচনা করা উচিত যে গিটহাব পৃষ্ঠাগুলির কার্যকারিতার কাজের প্রাথমিক নিমজ্জনের জন্য আপনাকে প্রথমে ইনস্টল করতে হবে Jekyll. সৌভাগ্যবশত, এটি আপনাকে সরাসরি সংগ্রহস্থলের উত্স থেকে একটি ওয়েবসাইট তৈরি করতে দেয় (আমি আমার পছন্দের সাথে এটি পুনরাবৃত্তি করব).

জেনারেটরের আমার পছন্দ প্রথম পয়েন্টের উপর ভিত্তি করে। পেলিক্যান্ পাইথনে লেখা যা জেকিলকে সহজেই প্রতিস্থাপন করেছে, যা আমার কাছে বিদেশী (প্রায় এক বছর ধরে এটি ব্যবহার করা হয়েছে). ফলস্বরূপ, এমনকি নিবন্ধ তৈরি এবং সম্পাদনা করা এবং একটি ওয়েবসাইটে কাজ করা আমার কাছে আকর্ষণীয় একটি ভাষায় অতিরিক্ত অভিজ্ঞতা দেয়।

__

সমস্যা গঠন

প্রধান কাজ হবে একটি স্ক্রিপ্ট লেখা (আসলে একটি কনফিগারেশন ফাইল) যা স্বয়ংক্রিয়ভাবে একটি ব্যক্তিগত সংগ্রহস্থল থেকে স্ট্যাটিক পেজ তৈরি করবে। সমাধানটি একটি ভার্চুয়াল পরিবেশের কার্যকারিতাকে জড়িত করবে। স্ক্রিপ্ট নিজেই পাবলিক রিপোজিটরিতে রেডিমেড পেজ যোগ করবে।

সমাধানের জন্য সরঞ্জাম

সমস্যা সমাধানের জন্য আমরা যে সরঞ্জামগুলি ব্যবহার করব:

• গিটহাব অ্যাকশন;
• Python3.7;
• চাতক;
• গিট;
• গিটহাব পেজ।

সম্ভাষণ

সুতরাং, ডকুমেন্টেশনের সাথে কিছুটা পরিচিত হওয়ার পরে এবং অ্যাকশনগুলির জন্য স্ক্রিপ্টগুলি কীভাবে লেখা হয় তা বোঝার পরে, এটি স্পষ্ট হয়ে গেছে যে এই প্রক্রিয়াটি যে সমস্যাটি দেখা দিয়েছে তা সম্পূর্ণরূপে সমাধান করবে। লেখার সময়, এই কার্যকারিতা ব্যবহার করার জন্য আপনাকে অবশ্যই সাবস্ক্রাইব করতে হবে। বিটা পরীক্ষার জন্য!

Github নিজেই নতুন কার্যকারিতা বর্ণনা

একটি অ্যাকশন স্ক্রিপ্ট লেখা একটি ফোল্ডারে একটি নামযুক্ত ফাইল তৈরি করে শুরু হয় .github এবং এর সাবফোল্ডার workflows. এটি ম্যানুয়ালি বা রিপোজিটরি পৃষ্ঠার অ্যাকশন ট্যাবে সম্পাদক থেকে করা যেতে পারে।

একটি ফাঁকা স্ক্রিপ্ট ফর্মের উদাহরণ

আমি সংক্ষেপে ফর্ম মন্তব্য করব

name: CI    # название скрипта: будет отображаться во вкладке Actions

on: [push]  # действие, по которому запускается данный скрипт

jobs:       # роботы, которые будут выполняться
  build:    # сборка, которая..

    runs-on: ubuntu-latest      # ..будет запущена на основе этого образа

    steps:              # шаги которые будут проделаны после запуска образа
    - uses: actions/checkout@v1     # переход в самую актуальную ветку
    - name: Run a one-line script   # имя работы номер 1
      run: echo Hello, world!       # суть работы номер 1 (bash-команда записана в одну строку)
    - name: Run a multi-line script   # имя работы номер 2
      run: |                    # суть работы номер 2 (многострочная)
        echo Add other actions to build,
        echo test, and deploy your project.

আসুন টেমপ্লেটের উপর ভিত্তি করে আমাদের নিজস্ব লিখি:

0) আপনি "CI" নামটিও ছেড়ে যেতে পারেন। এটা স্বাদের ব্যাপার।

1) এর পরে, আপনাকে অ্যাকশন/ট্রিগার নির্বাচন করতে হবে যা স্ক্রিপ্টটি চালু করবে, আমাদের ক্ষেত্রে এটি সংগ্রহস্থলে একটি নতুন প্রতিশ্রুতির স্বাভাবিক চাপ।

on:
  push

2) আমরা সেই চিত্রটিও ছেড়ে দেব যার ভিত্তিতে স্ক্রিপ্টটি একটি উদাহরণ হিসাবে চালু করা হবে, যেহেতু উবুন্টু প্রয়োজনীয় কার্যকারিতা নিয়ে বেশ সন্তুষ্ট। দিকে তাকাও উপলব্ধ সরঞ্জাম এটি স্পষ্ট হয়ে যায় যে এটি যে কোনও প্রয়োজনীয় বা সহজভাবে সুবিধাজনক চিত্র হতে পারে (বা এটির উপর ভিত্তি করে একটি ডকার ধারক)।

  build:
    runs-on: ubuntu-latest

3) ধাপে, আমরা প্রথমে মূল কাজের জন্য প্রস্তুতির জন্য পরিবেশ স্থাপন করব।

3.1) আমাদের প্রয়োজনীয় শাখায় যান (মানক পদক্ষেপ checkout):

- uses: actions/checkout@v1

3.2) পাইথন ইনস্টল করুন:

    - name: Set up Python
      uses: actions/setup-python@v1
      with:
        python-version: 3.7

3.3) আমাদের জেনারেটরের নির্ভরতা ইনস্টল করুন:

    - name: Install dependencies
      run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt

3.4) একটি ডিরেক্টরি তৈরি করুন যেখানে সাইটের পৃষ্ঠাগুলি তৈরি করা হবে:

   - name: Make output folder
      run: mkdir output

4) সাইটে কাজটি সামঞ্জস্যপূর্ণ হওয়ার জন্য, যেমন, পূর্ববর্তী পরিবর্তনগুলি মুছে ফেলার জন্য এবং বিরোধ ছাড়াই সাইটের সংগ্রহস্থলে পরিবর্তনগুলি যোগ করতে সক্ষম হওয়ার জন্য, পরবর্তী পদক্ষেপটি প্রতিবার সাইটের সংগ্রহস্থল ক্লোন করা হবে:

   - name: Clone master branch
      run: git clone "https://${{ secrets.ACCESS_TOKEN }}@github.com/${GITHUB_ACTOR}/${GITHUB_ACTOR}.github.io.git" --branch master --single-branch ./output

এই ধাপটি সিস্টেম ভেরিয়েবলকে কল করে:

• পরিবর্তনশীল GITHUB_ACTOR GitHub নিজেই ইন্সটল করে, এবং এটি সেই ব্যবহারকারীর নাম যার কারণে এই স্ক্রিপ্টটি চালু করা হয়েছিল;
• পরিবর্তনশীল secrets.ACCESS_TOKEN এই উত্পন্ন হয় Github পরিচালনার জন্য টোকেন, আমরা এটিকে ট্যাবে সেট করে পরিবেশ পরিবর্তনশীল হিসাবে পাস করতে পারি Secrets আমাদের সংগ্রহস্থল সেটিংস। অনুগ্রহ করে মনে রাখবেন যে প্রজন্মের সময় টোকেনটি আমাদের একবার সরবরাহ করা হবে, এটিতে আর কোনও অ্যাক্সেস থাকবে না। সেইসাথে সিক্রেট আইটেম মান.

5) আসুন আমাদের পৃষ্ঠাগুলি তৈরি করার দিকে এগিয়ে যাই:

   - name: Generate static pages
      run: pelican content -o output -s publishconf.py

জেনারেটরে পাস করা প্যারামিটারগুলি সেই ডিরেক্টরির জন্য দায়ী যেখানে জেনারেট করা ফাইলগুলি পাঠানো হবে (-o output) এবং কনফিগারেশন ফাইল যা আমরা তৈরি করতে ব্যবহার করি (-s publishconf.py; আপনি পেলিকান ডকুমেন্টেশনে প্রকাশনার জন্য স্থানীয় কনফিগারেশন এবং কনফিগারেশন আলাদা করার পদ্ধতি সম্পর্কে পড়তে পারেন).

আমাকে আমাদের ফোল্ডারে কি আছে মনে করিয়ে দিন output সাইট রিপোজিটরি ইতিমধ্যে ক্লোন করা হয়েছে.

6) আসুন গিট সেট আপ করি এবং আমাদের পরিবর্তিত ফাইলগুলিকে সূচী করি:

    - name: Set git config and add changes
      run: |
          git config --global user.email "${GITHUB_ACTOR}@https://users.noreply.github.com/"
          git config --global user.name "${GITHUB_ACTOR}"
          git add --all
      working-directory: ./output

এই মুহুর্তে, একটি ইতিমধ্যে পরিচিত ভেরিয়েবল ব্যবহার করা হয় এবং কার্যকরী ডিরেক্টরি নির্দেশিত হয় যেখানে এই ধাপের কমান্ডগুলি চালু করা হবে। ওয়ার্কিং ডিরেক্টরিতে যাওয়ার কমান্ডটি অন্যথায় এরকম দেখাবে - cd output.

7) আসুন একটি প্রতিশ্রুতি বার্তা তৈরি করি, পরিবর্তনগুলি কমিট করি এবং সেগুলিকে সংগ্রহস্থলে পুশ করি। যাতে প্রতিশ্রুতি নিরর্থক না হয় এবং তাই bash-এ একটি ত্রুটি তৈরি না করে (আউটপুট ফলাফল নয় 0) — প্রথমে, আসুন পরীক্ষা করে দেখি যে আদৌ কিছু কমিট করা এবং পুশ করা প্রয়োজন কিনা। এটি করার জন্য আমরা কমান্ড ব্যবহার করি git diff-index --quiet --cached HEAD -- যা টার্মিনালে আউটপুট হবে 0 যদি সাইটের পূর্ববর্তী সংস্করণের তুলনায় কোন পরিবর্তন না হয়, এবং 1 এই ধরনের পরিবর্তন আছে। তারপর আমরা এই কমান্ডের ফলাফল প্রক্রিয়া. এইভাবে, স্ক্রিপ্টটি কার্যকর করার তথ্যে, আমরা স্বয়ংক্রিয়ভাবে ক্র্যাশ হওয়ার পরিবর্তে এবং স্ক্রিপ্ট ক্র্যাশ সম্পর্কে আমাদের একটি প্রতিবেদন পাঠানোর পরিবর্তে এই পর্যায়ে সাইটের অবস্থা সম্পর্কে দরকারী তথ্য রেকর্ড করব।

আমরা রেডিমেড পৃষ্ঠাগুলির সাথে আমাদের ডিরেক্টরিতে এই ক্রিয়াগুলিও সম্পাদন করি।

   - name: Push and send notification
      run: |
          COMMIT_MESSAGE="Update pages on $(date +'%Y-%m-%d %H:%M:%S')"
          git diff-index --quiet --cached HEAD -- && echo "No changes!" && exit 0 || echo $COMMIT_MESSAGE
          # Only if repo have changes
          git commit -m "${COMMIT_MESSAGE}"
          git push https://${{ secrets.ACCESS_TOKEN }}@github.com/${GITHUB_ACTOR}/${GITHUB_ACTOR}.github.io.git master
      working-directory: ./output

ফল

ফলস্বরূপ, এই জাতীয় স্ক্রিপ্ট আপনাকে স্ট্যাটিক পৃষ্ঠাগুলি তৈরি করার বিষয়ে চিন্তা করতে দেয় না। একটি প্রাইভেট রিপোজিটরিতে সরাসরি পরিবর্তন যোগ করে, যেকোনো সিস্টেমের অধীনে থেকে গিট দিয়ে কাজ করে বা GitHub ওয়েব ইন্টারফেসের মাধ্যমে একটি ফাইল তৈরি করে, অ্যাকশন নিজেই সবকিছু করবে। স্ক্রিপ্টটি অপ্রত্যাশিতভাবে ক্র্যাশ হলে, আপনার ইমেলে একটি বিজ্ঞপ্তি পাঠানো হবে।

সম্পূর্ণ কোড

আমি আমার কাজের সংস্করণটি ছেড়ে দেব, যেখানে শেষ পদক্ষেপটি একটি বিজ্ঞপ্তি পাঠানোর যোগ করে যে একটি প্রতিশ্রুতি মূল সংগ্রহস্থলে ঠেলে দেওয়া হয়েছে।

উপরে বর্ণিত গোপনীয়তাগুলি ব্যবহার করা হয়, যেখানে বট টোকেন এবং ব্যবহারকারীর আইডি যাকে বার্তা পাঠানো প্রয়োজন তা যোগ করা হয়।

name: Push content to the user's GitHub pages repository

on:
  push

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
    - uses: actions/checkout@v1
    - name: Set up Python
      uses: actions/setup-python@v1
      with:
        python-version: 3.7
    - name: Install dependencies
      run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt
    - name: Make output folder
      run: mkdir output
    - name: Clone master branch
      run: git clone "https://${{ secrets.ACCESS_TOKEN }}@github.com/${GITHUB_ACTOR}/${GITHUB_ACTOR}.github.io.git" --branch master --single-branch ./output
    - name: Generate static pages
      run: pelican content -o output -s publishconf.py
    - name: Set git config and add changes
      run: |
          git config --global user.email "${GITHUB_ACTOR}@https://users.noreply.github.com/"
          git config --global user.name "${GITHUB_ACTOR}"
          git add --all
      working-directory: ./output
    - name: Push and send notification
      run: |
          COMMIT_MESSAGE="Update pages on $(date +'%Y-%m-%d %H:%M:%S')"
          git diff-index --quiet --cached HEAD -- && echo "No changes!" && exit 0 || echo $COMMIT_MESSAGE
          git commit -m "${COMMIT_MESSAGE}"
          git push https://${{ secrets.ACCESS_TOKEN }}@github.com/${GITHUB_ACTOR}/${GITHUB_ACTOR}.github.io.git master
          curl "https://api.telegram.org/bot${{ secrets.BOT_TOKEN }}/sendMessage?text=$COMMIT_MESSAGE %0ALook at ${GITHUB_ACTOR}.github.io %0ARepository%3A github.com/${GITHUB_ACTOR}/${GITHUB_ACTOR}.github.io&chat_id=${{ secrets.ADMIN_ID }}"
      working-directory: ./output

স্ক্রিনশট

সোর্স রিপোজিটরির অ্যাকশন ট্যাবে প্রদর্শিত রানগুলির একটির ফলাফল

স্ক্রিপ্ট সম্পূর্ণ হওয়ার বিষয়ে বট থেকে বার্তা

দরকারী লিঙ্ক

কর্ম বোঝার
অ্যাকশন সিনট্যাক্স
ট্রিগারের তালিকা
ভার্চুয়াল পরিবেশের জন্য বিকল্প
Github পেজ
স্ট্যাটিক জেনারেটরের তালিকা

উত্স: www.habr.com