GitHub অ্যাকশন সহ নরকের বৃত্ত (একটি জাভা প্রকল্পের জন্য একটি CI/CD পাইপলাইন তৈরি করা)

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

আমরা কি স্বয়ংক্রিয় হবে?

প্রথমত, আমাদের একটি প্রকল্প দরকার যা আমরা স্বয়ংক্রিয়ভাবে করব, আসুন স্প্রিং বুট / জাভা 11 / ম্যাভেনে একটি ছোট অ্যাপ্লিকেশন তৈরি করি। এই নিবন্ধটির উদ্দেশ্যে, আমরা অ্যাপ্লিকেশন যুক্তিতে মোটেও আগ্রহী হব না; অ্যাপ্লিকেশনটির চারপাশের অবকাঠামো আমাদের জন্য গুরুত্বপূর্ণ, তাই একটি সাধারণ REST API কন্ট্রোলার আমাদের জন্য যথেষ্ট হবে।

আপনি এখানে উত্স দেখতে পারেন: github.com/antkorwin/github-actions একটি পাইপলাইন নির্মাণের সমস্ত পর্যায়ে এই প্রকল্পের জন্য টান অনুরোধ প্রতিফলিত হয়.

জিরা এবং পরিকল্পনা

এটা বলার মতো যে আমরা সাধারণত JIRA কে একটি ইস্যু ট্র্যাকার হিসাবে ব্যবহার করি, তাই আসুন এই প্রকল্পের জন্য একটি পৃথক বোর্ড তৈরি করি এবং সেখানে প্রথম সমস্যাগুলি যোগ করি:

একটু পরে আমরা JIRA এবং GitHub সংমিশ্রণে কী আকর্ষণীয় জিনিস অফার করতে পারে সেগুলিতে ফিরে যাব।

আমরা প্রকল্পের সমাবেশ স্বয়ংক্রিয়

আমাদের পরীক্ষা প্রকল্পটি ম্যাভেনের মাধ্যমে তৈরি করা হয়েছে, তাই এটি তৈরি করা বেশ সহজ, আমাদের যা দরকার তা হল mvn ক্লিন প্যাকেজ।

গিথুব অ্যাকশন ব্যবহার করে এটি করার জন্য, আমাদের ওয়ার্কফ্লো বর্ণনা করে সংগ্রহস্থলে একটি ফাইল তৈরি করতে হবে, এটি একটি নিয়মিত yml ফাইল দিয়ে করা যেতে পারে, আমি বলতে পারি না যে আমি "yml প্রোগ্রামিং" পছন্দ করি, তবে আমরা কী করতে পারি - আমরা এটি .github/ ডিরেক্টরি ওয়ার্কফ্লো/ ফাইল build.yml-এ করি যেখানে আমরা মাস্টার শাখা তৈরি করার সময় ক্রিয়াগুলি বর্ণনা করব:

name: Build

on:
  pull_request:
    branches:
      - '*'
  push:
    branches:
      - 'master'

jobs:
  build:
    runs-on: ubuntu-18.04
    steps:
      - uses: actions/checkout@v1
      - name: set up JDK 11
        uses: actions/setup-java@v1
        with:
          java-version: 1.11
      - name: Maven Package
        run: mvn -B clean package -DskipTests

on — এটি সেই ইভেন্টের একটি বিবরণ যেখানে আমাদের স্ক্রিপ্টটি চালু করা হবে৷

অন: pull_request/push — নির্দেশ করে যে প্রত্যেকবার মাস্টারের কাছে ধাক্কা দেওয়া এবং পুল অনুরোধ তৈরি করা হলে এই ওয়ার্কফ্লো চালু করা দরকার।

নিম্নে কাজের বর্ণনা দেওয়া হল (কাজ) এবং কার্যকর করার পদক্ষেপ (ধাপ) প্রতিটি কাজের জন্য।

উপর সঞ্চালিত হয় - এখানে আমরা লক্ষ্য ওএস নির্বাচন করতে পারি, আশ্চর্যজনকভাবে, আপনি ম্যাক ওএসও চয়ন করতে পারেন, তবে ব্যক্তিগত সংগ্রহস্থলগুলিতে এটি বেশ ব্যয়বহুল (লিনাক্সের তুলনায়)।

ব্যবহারসমূহ আপনাকে অন্যান্য ক্রিয়াগুলি পুনরায় ব্যবহার করার অনুমতি দেয়, উদাহরণস্বরূপ, অ্যাকশন/সেটআপ-জাভা অ্যাকশন ব্যবহার করে আমরা Java 11 এর জন্য পরিবেশ ইনস্টল করি।

এর সাহায্যে সঙ্গে আমরা যে প্যারামিটারগুলি দিয়ে আমরা অ্যাকশন চালু করি তা নির্দিষ্ট করতে পারি, মূলত এই আর্গুমেন্টগুলি যা অ্যাকশনে পাঠানো হবে।

যা বাকি আছে তা হল মাভেনে প্রজেক্ট বিল্ড চালানো: run: mvn -B clean package পতাকা -B বলে যে আমাদের একটি নন-ইন্টারেক্টিভ মোড দরকার যাতে মাভেন হঠাৎ আমাদের কিছু জিজ্ঞাসা করতে না চায়

দারুণ! এখন, যতবার আপনি মাস্টারের কাছে প্রতিশ্রুতিবদ্ধ হন, প্রকল্প তৈরি শুরু হয়।

স্বয়ংক্রিয় পরীক্ষা লঞ্চ

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

আমরা একটি পুল অনুরোধ তৈরি করার সময় পরীক্ষা চালাব এবং মাস্টারের সাথে একীভূত করব এবং একই সময়ে আমরা কোড-কভারেজের উপর একটি প্রতিবেদন তৈরি করব।

name: Build

on:
  pull_request:
    branches:
      - '*'
  push:
    branches:
      - 'master'

jobs:
  build:
    runs-on: ubuntu-18.04
    steps:
      - uses: actions/checkout@v1
      - name: set up JDK 11
        uses: actions/setup-java@v1
        with:
          java-version: 1.11
      - name: Maven Verify
        run: mvn -B clean verify
      - name: Test Coverage
        uses: codecov/codecov-action@v1
        with:
          token: ${{ secrets.CODECOV_TOKEN }}

পরীক্ষাগুলি কভার করতে, আমি jacoco প্লাগইনের সাথে একযোগে কোডকভ ব্যবহার করি। কোডকভের নিজস্ব ক্রিয়া রয়েছে, তবে আমাদের পুল অনুরোধের সাথে কাজ করার জন্য এটির একটি টোকেন প্রয়োজন:

${{ secrets.CODECOV_TOKEN }} — আমরা এই নির্মাণটি একাধিকবার দেখতে পাব, সিক্রেটস হল গিটহাবে গোপনীয়তা সংরক্ষণের একটি প্রক্রিয়া, আমরা সেখানে পাসওয়ার্ড/টোকেন/হোস্ট/ইউআরএল এবং অন্যান্য ডেটা লিখতে পারি যা সংগ্রহস্থল কোড বেসে অন্তর্ভুক্ত করা উচিত নয়।

আপনি গিটহাবের সংগ্রহস্থল সেটিংসে গোপনীয়তায় একটি পরিবর্তনশীল যুক্ত করতে পারেন:

আপনি একটি টোকেন পেতে পারেন codecov.io গিটহাবের মাধ্যমে অনুমোদনের পরে, একটি সর্বজনীন প্রকল্প যুক্ত করার জন্য আপনাকে কেবল এইরকম একটি লিঙ্ক অনুসরণ করতে হবে: GitHub ব্যবহারকারীর নাম/[রেপো নাম]। একটি ব্যক্তিগত সংগ্রহস্থলও যোগ করা যেতে পারে; এটি করার জন্য, আপনাকে গিথুবে অ্যাপ্লিকেশনটিতে কোডকভ অধিকার দিতে হবে।

POM ফাইলে জ্যাকোকো প্লাগইন যোগ করুন:

<plugin>
	<groupId>org.jacoco</groupId>
	<artifactId>jacoco-maven-plugin</artifactId>
	<version>0.8.4</version>
	<executions>
		<execution>
			<goals>
				<goal>prepare-agent</goal>
			</goals>
		</execution>
		<!-- attached to Maven test phase -->
		<execution>
			<id>report</id>
			<phase>test</phase>
			<goals>
				<goal>report</goal>
			</goals>
		</execution>
	</executions>
</plugin>
<plugin>
	<groupId>org.apache.maven.plugins</groupId>
	<artifactId>maven-surefire-plugin</artifactId>
	<version>2.22.2</version>
	<configuration>
		<reportFormat>plain</reportFormat>
		<includes>
			<include>**/*Test*.java</include>
			<include>**/*IT*.java</include>
		</includes>
	</configuration>
</plugin>

এখন কোডকভ বট আমাদের প্রতিটি পুল অনুরোধে প্রবেশ করবে এবং একটি কভারেজ পরিবর্তন গ্রাফ যোগ করবে:

এর একটি স্ট্যাটিক বিশ্লেষক যোগ করা যাক

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

এটি একটি কর্মের মাধ্যমে সম্ভব নয়, তাই আমরা এমভিএন প্লাগইনের মাধ্যমে এটি করব:

name: SonarCloud

on:
  push:
    branches:
      - master
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  sonarcloud:
    runs-on: ubuntu-16.04
    steps:
      - uses: actions/checkout@v1
      - name: Set up JDK
        uses: actions/setup-java@v1
        with:
          java-version: 1.11
      - name: Analyze with SonarCloud
#       set environment variables:
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
#       run sonar maven plugin:
        run: mvn -B verify sonar:sonar -Dsonar.projectKey=antkorwin_github-actions -Dsonar.organization=antkorwin-github -Dsonar.host.url=https://sonarcloud.io -Dsonar.login=$SONAR_TOKEN -Dsonar.coverage.jacoco.xmlReportPaths=./target/site/jacoco/jacoco.xml

SONAR_TOKEN -এ পাওয়া যাবে sonarcloud.io এবং আপনাকে এটি গোপনে নিবন্ধন করতে হবে। GITHUB_TOKEN - এটি একটি অন্তর্নির্মিত টোকেন যা গিটহাব তৈরি করে, যার সাহায্যে সোনারক্লাউড [বট] আমাদের পুল অনুরোধে বার্তাগুলি পাঠাতে গিটে লগ ইন করতে সক্ষম হবে।

Dsonar.projectKey — সোনার প্রকল্পের নাম, আপনি এটি প্রকল্প সেটিংসে দেখতে পারেন।

Dsonar.organization — গিটহাব থেকে সংস্থার নাম।

আমরা একটি টান অনুরোধ করি এবং সোনারক্লাউড [বট] মন্তব্যে আসার জন্য অপেক্ষা করি:

প্রশাসনিক অতিক্রম

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

কর্মক্ষেত্রে, আমার কাছে এমন প্রকল্প রয়েছে যার কোড বেস বিটবাকেটের মধ্যে রয়েছে (সবকিছুই সেই গল্পের মতো "আমি দিনে বিটবাকেট লিখি, রাতে গিটহাবে কমিট করি")। দুর্ভাগ্যবশত, বিটবাকেটের বিল্ট-ইন রিলিজ ম্যানেজমেন্ট টুল নেই। এটি একটি সমস্যা, কারণ প্রতিটি রিলিজের জন্য আপনাকে ম্যানুয়ালি সঙ্গমে একটি পৃষ্ঠা তৈরি করতে হবে এবং সেখানে রিলিজের অন্তর্ভুক্ত সমস্ত বৈশিষ্ট্য নিক্ষেপ করতে হবে, মনের প্রাসাদগুলি অনুসন্ধান করতে হবে, জিরার কাজগুলি, ভান্ডারে কমিট করতে হবে। একটি ভুল করার অনেক সম্ভাবনা রয়েছে, আপনি কিছু ভুলে যেতে পারেন বা এমন কিছু লিখতে পারেন যা ইতিমধ্যেই গতবার প্রকাশিত হয়েছিল, কখনও কখনও এটি স্পষ্ট হয় না যে একটি পুল অনুরোধকে কী হিসাবে শ্রেণীবদ্ধ করতে হবে - এটি একটি বৈশিষ্ট্য বা একটি বাগ সংশোধন, বা সম্পাদনা পরীক্ষা, বা অবকাঠামোগত কিছু।

কিভাবে GitHub কর্ম আমাদের সাহায্য করতে পারে? একটি দুর্দান্ত অ্যাকশন রয়েছে - রিলিজ ড্রাফটার, এটি আপনাকে রিলিজ নোট ফাইল টেমপ্লেট সেট আপ করার জন্য পুল অনুরোধের বিভাগ সেট আপ করতে এবং রিলিজ নোট ফাইলে স্বয়ংক্রিয়ভাবে গোষ্ঠীবদ্ধ করতে দেয়:

একটি রিপোর্ট সেট আপ করার জন্য উদাহরণ টেমপ্লেট (.github/release-drafter.yml):

name-template: 'v$NEXT_PATCH_VERSION'
tag-template: 'v$NEXT_PATCH_VERSION'
categories:
  - title: ' New Features'
    labels:
      - 'type:features'
# в эту категорию собираем все PR с меткой type:features

  - title: ' Bugs Fixes'
    labels:
      - 'type:fix'
# аналогично для метки type:fix и т.д.

  - title: ' Documentation'
    labels:
      - 'type:documentation'

  - title: ' Configuration'
    labels:
      - 'type:config'

change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
template: |
  ## Changes
  $CHANGES

একটি খসড়া রিলিজ তৈরি করতে একটি স্ক্রিপ্ট যোগ করুন (.github/workflows/release-draft.yml):

name: "Create draft release"

on:
  push:
    branches:
      - master

jobs:
  update_draft_release:
    runs-on: ubuntu-18.04
    steps:
      - uses: release-drafter/release-drafter@v5
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

এখন থেকে সমস্ত পুল অনুরোধ স্বয়ংক্রিয়ভাবে রিলিজ নোটে সংগ্রহ করা হবে - ম্যাজিক!

এখানে প্রশ্ন উঠতে পারে: ডেভেলপাররা যদি পিআর-এ ট্যাগ দিতে ভুলে যান? তারপরে এটি কোন বিভাগে রাখা হবে তা পরিষ্কার নয় এবং আবার আপনাকে প্রতিটি পিআরের সাথে আলাদাভাবে ম্যানুয়ালি মোকাবেলা করতে হবে। এই সমস্যাটি সমাধান করতে, আমরা অন্য একটি ক্রিয়া ব্যবহার করতে পারি - লেবেল যাচাইকারী - এটি পুল অনুরোধে ট্যাগের উপস্থিতি পরীক্ষা করে। যদি কোন প্রয়োজনীয় ট্যাগ না থাকে, তাহলে চেক ব্যর্থ হবে এবং আমরা আমাদের পুল অনুরোধে এই সম্পর্কে একটি বার্তা দেখতে পাব।

name: "Verify type labels"

on:
  pull_request:
    types: [opened, labeled, unlabeled, synchronize]

jobs:
  triage:
    runs-on: ubuntu-18.04
    steps:
      - uses: zwaldowski/match-label-action@v2
        with:
          allowed: 'type:fix, type:features, type:documentation, type:tests, type:config'

এখন যে কোনো পুল-অনুরোধ ট্যাগগুলির মধ্যে একটি দিয়ে চিহ্নিত করা আবশ্যক: type:fix, type:features, type:documentation, type:tests, type:config।

টান অনুরোধ স্বয়ংক্রিয় টীকা

যেহেতু আমরা পুল অনুরোধের সাথে কার্যকরী কাজের মতো একটি বিষয় স্পর্শ করেছি, তাই লেবেলারের মতো একটি ক্রিয়া সম্পর্কে কথা বলা মূল্যবান, এটি পিআর-এ ট্যাগ রাখে যার ভিত্তিতে ফাইলগুলি পরিবর্তন করা হয়েছে। উদাহরণ স্বরূপ, ডিরেক্টরির পরিবর্তন ধারণ করে এমন যেকোনো টান অনুরোধকে আমরা [বিল্ড] হিসেবে চিহ্নিত করতে পারি .github/workflow.

এটি সংযোগ করা বেশ সহজ:

name: "Auto-assign themes to PR"

on:
  - pull_request

jobs:
  triage:
    runs-on: ubuntu-18.04
    steps:
      - uses: actions/labeler@v2
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

এছাড়াও আমাদের একটি ফাইল প্রয়োজন যাতে প্রকল্প ডিরেক্টরি এবং পুল অনুরোধের বিষয়গুলির মধ্যে চিঠিপত্র বর্ণনা করা হয়:

theme:build:
  - ".github/**"
  - "pom.xml"
  - ".travis.yml"
  - ".gitignore"
  - "Dockerfile"

theme:code:
  - "src/main/*"

theme:tests:
  - "src/test/*"

theme:documentation:
  - "docs/**"

theme:TRASH:
  - ".idea/**"
  - "target/**"

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

এটা স্থাপন করার সময়

আমি গিটহাব অ্যাকশনের মাধ্যমে (ssh এর মাধ্যমে, scp এর মাধ্যমে এবং ডকার-হাব ব্যবহার করে) বেশ কয়েকটি স্থাপনার বিকল্প চেষ্টা করেছি এবং আমি বলতে পারি যে, সম্ভবত, আপনি বাইনারিটি সার্ভারে আপলোড করার একটি উপায় খুঁজে পাবেন, আপনার পাইপলাইন যতই বাঁকা হোক না কেন। হয়

আমি সম্পূর্ণ অবকাঠামো এক জায়গায় রাখার বিকল্পটি পছন্দ করেছি, তাই আসুন GitHub প্যাকেজগুলিতে কীভাবে স্থাপন করা যায় তা দেখুন (এটি বাইনারি সামগ্রী, এনপিএম, জার, ডকারের জন্য একটি সংগ্রহস্থল)।

একটি ডকার ইমেজ তৈরি এবং GitHub প্যাকেজে প্রকাশ করার জন্য স্ক্রিপ্ট:

name: Deploy docker image

on:
  push:
    branches:
      - 'master'

jobs:

  build_docker_image:
    runs-on: ubuntu-18.04
    steps:

#     Build JAR:
      - uses: actions/checkout@v1
      - name: set up JDK 11
        uses: actions/setup-java@v1
        with:
          java-version: 1.11
      - name: Maven Package
        run: mvn -B clean compile package -DskipTests

#     Set global environment variables:
      - name: set global env
        id: global_env
        run: |
          echo "::set-output name=IMAGE_NAME::${GITHUB_REPOSITORY#*/}"
          echo "::set-output name=DOCKERHUB_IMAGE_NAME::docker.pkg.github.com/${GITHUB_REPOSITORY}/${GITHUB_REPOSITORY#*/}"

#     Build Docker image:
      - name: Build and tag image
        run: |
          docker build -t "${{ steps.global_env.outputs.DOCKERHUB_IMAGE_NAME }}:latest" -t "${{ steps.global_env.outputs.DOCKERHUB_IMAGE_NAME }}:${GITHUB_SHA::8}" .

      - name: Docker login
        run: docker login docker.pkg.github.com -u $GITHUB_ACTOR -p ${{secrets.GITHUB_TOKEN}}

#     Publish image to github package repository:
      - name: Publish image
        env:
          IMAGE_NAME: $GITHUB_REPOSITORY
        run: docker push "docker.pkg.github.com/$GITHUB_REPOSITORY/${{ steps.global_env.outputs.IMAGE_NAME }}"

প্রথমত, আমাদের অ্যাপ্লিকেশনটির JAR ফাইল তৈরি করতে হবে, তারপরে আমরা গিটহাব ডকার রেজিস্ট্রির পথ এবং আমাদের চিত্রের নাম গণনা করি। এখানে কয়েকটি কৌশল রয়েছে যা আমরা এখনও খুঁজে পাইনি:

• একটি নির্মাণের মতো: echo “::set-output name=NAME::VALUE” আপনাকে বর্তমান ধাপে একটি ভেরিয়েবলের মান সেট করতে দেয়, যাতে এটি অন্য সব ধাপে পড়া যায়।
• আপনি এই ধাপের শনাক্তকারীর মাধ্যমে পূর্ববর্তী ধাপে সেট করা ভেরিয়েবলের মান পেতে পারেন: ${{ steps.global_env.outputs.DOCKERHUB_IMAGE_NAME }}
• স্ট্যান্ডার্ড GITHUB_REPOSITORY ভেরিয়েবল রিপোজিটরির নাম এবং এর মালিক ("মালিক/রেপো-নাম") সংরক্ষণ করে। সংগ্রহস্থলের নাম ব্যতীত এই লাইন থেকে সবকিছু কাটাতে, আমরা ব্যাশ সিনট্যাক্স ব্যবহার করব: ${GITHUB_REPOSITORY#*/}

পরবর্তীতে আমাদের ডকার ইমেজ তৈরি করতে হবে:

docker build -t "docker.pkg.github.com/antkorwin/github-actions/github-actions:latest"

রেজিস্ট্রিতে লগ ইন করুন:

docker login docker.pkg.github.com -u $GITHUB_ACTOR -p ${{secrets.GITHUB_TOKEN}}

এবং চিত্রটি GitHub প্যাকেজ সংগ্রহস্থলে প্রকাশ করুন:

docker push "docker.pkg.github.com/antkorwin/github-actions/github-actions"

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

যদি সবকিছু ভালভাবে কাজ করে, তাহলে সংগ্রহস্থলে প্যাকেজ বিভাগ (https://github.com/antkorwin/github-actions/packages) খুললে, আপনি একটি নতুন ডকার চিত্র দেখতে পাবেন:

সেখানে আপনি ডকার ইমেজের সংস্করণগুলির একটি তালিকাও দেখতে পারেন।

যা অবশিষ্ট থাকে তা হল এই রেজিস্ট্রির সাথে কাজ করার জন্য আমাদের সার্ভার কনফিগার করা এবং পরিষেবাটি পুনরায় চালু করা। আমি সম্ভবত অন্য সময় systemd এর মাধ্যমে এটি কীভাবে করতে হয় সে সম্পর্কে কথা বলব।

পর্যবেক্ষণ

গিটহাব অ্যাকশন ব্যবহার করে আমাদের অ্যাপ্লিকেশনের জন্য কীভাবে স্বাস্থ্য পরীক্ষা করা যায় তার একটি সহজ বিকল্প দেখুন। আমাদের বুট অ্যাপ্লিকেশনটিতে একটি অ্যাকচুয়েটর রয়েছে, তাই এর স্থিতি পরীক্ষা করার জন্য আমাদের একটি API লিখতেও হবে না; আমরা ইতিমধ্যেই অলসদের জন্য সবকিছু করেছি। আপনাকে শুধু হোস্ট টানতে হবে: SERVER-URL:PORT/actuator/health

$ curl -v 127.0.0.1:8080/actuator/health

> GET /actuator/health HTTP/1.1
> Host: 127.0.0.1:8080
> User-Agent: curl/7.61.1
> Accept: */*

< HTTP/1.1 200
< Content-Type: application/vnd.spring-boot.actuator.v3+json
< Transfer-Encoding: chunked
< Date: Thu, 04 Jun 2020 12:33:37 GMT

{"status":"UP"}

ক্রন ব্যবহার করে সার্ভার চেক করার জন্য আমাদের যা দরকার তা হল একটি টাস্ক লিখতে, এবং যদি হঠাৎ এটি আমাদের উত্তর না দেয়, তাহলে আমরা টেলিগ্রামের মাধ্যমে একটি বিজ্ঞপ্তি পাঠাব।

প্রথমে, আসুন জেনে নেই কিভাবে একটি ক্রন ওয়ার্কফ্লো চালাতে হয়:

on:
  schedule:
    - cron:  '*/5 * * * *'

এটা সহজ, আমি বিশ্বাসও করতে পারি না যে গিথুবে আপনি এমন ইভেন্ট তৈরি করতে পারেন যা একেবারেই ওয়েবহুকের সাথে খাপ খায় না। বিস্তারিত ডকুমেন্টেশনে আছে: help.github.com/en/actions/reference/events-that-trigger-workflows#scheduled-events-schedule

কার্ল এর মাধ্যমে ম্যানুয়ালি সার্ভারের স্থিতি পরীক্ষা করা যাক:

jobs:
  ping:
    runs-on: ubuntu-18.04
    steps:

      - name: curl actuator
        id: ping
        run: |
          echo "::set-output name=status::$(curl ${{secrets.SERVER_HOST}}/api/actuator/health)"

      - name: health check
        run: |
          if [[ ${{ steps.ping.outputs.status }} != *"UP"* ]]; then
            echo "health check is failed"
            exit 1
          fi
          echo "It's OK"

প্রথমত, সার্ভার অনুরোধে কী প্রতিক্রিয়া জানিয়েছে তা আমরা একটি ভেরিয়েবলে সংরক্ষণ করি, পরবর্তী ধাপে আমরা স্ট্যাটাসটি UP কিনা তা পরীক্ষা করি এবং যদি এটি না হয়, তাহলে আমরা একটি ত্রুটি সহ প্রস্থান করি। আপনি যদি আপনার হাত দিয়ে একটি কর্ম "আবিষ্ট" করতে চান, তাহলে প্রস্থান 1 - উপযুক্ত অস্ত্র।

  - name: send alert in telegram
    if: ${{ failure() }}
    uses: appleboy/telegram-action@master
    with:
      to: ${{ secrets.TELEGRAM_TO }}
      token: ${{ secrets.TELEGRAM_TOKEN }}
      message: |
        Health check of the:
        ${{secrets.SERVER_HOST}}/api/actuator/health
        failed with the result:
        ${{ steps.ping.outputs.status }}

পূর্ববর্তী ধাপে কাজ ব্যর্থ হলেই আমরা টেলিগ্রামে পাঠাই। একটি বার্তা পাঠাতে আমরা অ্যাপলবয়/টেলিগ্রাম-অ্যাকশন ব্যবহার করি; আপনি ডকুমেন্টেশনে একটি বট টোকেন এবং চ্যাট আইডি কীভাবে পেতে হয় সে সম্পর্কে পড়তে পারেন: github.com/appleboy/telegram-action

Github-এ গোপনীয়তায় লিখতে ভুলবেন না: সার্ভারের URL এবং টেলিগ্রাম বটের জন্য টোকেন।

বোনাস ট্র্যাক - অলস জন্য JIRA

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

GitHub এই রুটিন টাস্কে আমাদের সাহায্য করবে; শুরু করার জন্য, আমরা যখন একটি পুল অনুরোধ জমা দিই তখন আমরা কোড_রিভিউ কলামে সমস্যাগুলিকে স্বয়ংক্রিয়ভাবে টেনে আনতে পারি। আপনাকে যা করতে হবে তা হল শাখার নামকরণের নিয়ম অনুসরণ করুন:

[имя проекта]-[номер таска]-название

উদাহরণস্বরূপ, যদি প্রকল্প কী "GitHub অ্যাকশন" GA হয়, তাহলে GA-8-jira-bot GA-8 টাস্ক বাস্তবায়নের জন্য একটি শাখা হতে পারে।

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

প্রথমে আপনাকে অ্যাকশন ব্যবহার করে JIRA-তে লগ ইন করতে হবে: atlassian/gajira-login

jobs:
  build:
    runs-on: ubuntu-latest
    name: Jira Workflow
    steps:
      - name: Login
        uses: atlassian/gajira-login@master
        env:
          JIRA_BASE_URL: ${{ secrets.JIRA_BASE_URL }}
          JIRA_USER_EMAIL: ${{ secrets.JIRA_USER_EMAIL }}
          JIRA_API_TOKEN: ${{ secrets.JIRA_API_TOKEN }}

এটি করার জন্য, আপনাকে JIRA-তে একটি টোকেন পেতে হবে, এটি কীভাবে করতে হবে তা এখানে বর্ণনা করা হয়েছে: confluence.atlassian.com/cloud/api-tokens-938839638.html

আমরা শাখার নাম থেকে টাস্ক শনাক্তকারী বের করি:

  - name: Find Issue
    id: find_issue
    shell: bash
    run: |
      echo "::set-output name=ISSUE_ID::$(echo ${GITHUB_HEAD_REF} | egrep -o 'GA-[0-9]{1,4}')"
      echo brach name: $GITHUB_HEAD_REF
      echo extracted issue: ${GITHUB_HEAD_REF} | egrep -o 'GA-[0-9]{1,4}'

  - name: Check Issue
    shell: bash
    run: |
      if [[ "${{steps.find_issue.outputs.ISSUE_ID}}" == "" ]]; then
        echo "Please name your branch according to the JIRA issue: [project_key]-[task_number]-branch_name"
        exit 1
      fi
      echo succcessfully found JIRA issue: ${{steps.find_issue.outputs.ISSUE_ID}}

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

একটি পুল অনুরোধ তৈরি করার সময় যা অবশিষ্ট থাকে তা হল "কোড পর্যালোচনা" কলামে কাজটি সরানো:

  - name: Transition issue
    if: ${{ success() }}
    uses: atlassian/gajira-transition@master
    with:
      issue: ${{ steps.find_issue.outputs.ISSUE_ID }}
      transition: "Code review"

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

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

তথ্যও

আপনি যদি ক্লাসিক DEVOPS ডায়াগ্রামটি দেখেন, আমরা সম্ভবত পরিচালনা ব্যতীত সমস্ত পর্যায়ে কভার করেছি, আমি মনে করি আপনি যদি চেষ্টা করেন, আপনি হেল্প-ডেস্ক সিস্টেমের সাথে একীকরণের জন্য বাজারে কিছু পদক্ষেপ খুঁজে পেতে পারেন, তাই আমরা ধরে নেব যে পাইপলাইনটি পরিণত হয়েছে পুঙ্খানুপুঙ্খ হতে হবে এবং এর ব্যবহারের উপর ভিত্তি করে উপসংহার টানা যেতে পারে।

পেশাদাররা:

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

কনস:

• YML, ভাল, আমি তাকে পছন্দ করি না। এই ধরনের একটি প্রবাহের সাথে কাজ করার সময়, আমার কাছে সবচেয়ে সাধারণ কমিট মেসেজটি হল "ফিক্স ইএমএল ফরম্যাট", তারপরে আপনি কোথাও একটি ট্যাব রাখতে ভুলে গেছেন, অথবা আপনি এটি ভুল লাইনে লিখছেন। সাধারণভাবে, একটি প্রটেক্টর এবং শাসকের সাথে একটি পর্দার সামনে বসা সবচেয়ে আনন্দদায়ক অভিজ্ঞতা নয়।
• ডিবাগ, কমিট দিয়ে ফ্লো ডিবাগ করা, পুনর্নির্মাণ চালানো এবং কনসোলে আউটপুট করা সবসময় সুবিধাজনক নয়, তবে এটি "আপনি ওভারডন" বিভাগের বেশি; আপনি সুবিধাজনক IDEA এর সাথে কাজ করতে অভ্যস্ত, যখন আপনি যেকোনো কিছু ডিবাগ করতে পারেন .
• আপনি যেকোন কিছুর উপর আপনার ক্রিয়া লিখতে পারেন যদি আপনি এটিকে ডকারে মোড়ানো থাকে তবে শুধুমাত্র জাভাস্ক্রিপ্ট স্থানীয়ভাবে সমর্থিত, অবশ্যই এটি স্বাদের বিষয়, তবে আমি js এর পরিবর্তে অন্য কিছু পছন্দ করব।

আমি আপনাকে মনে করিয়ে দিই যে সমস্ত স্ক্রিপ্ট সহ সংগ্রহস্থলটি এখানে রয়েছে: github.com/antkorwin/github-actions

আগামী সপ্তাহে আমি সঙ্গে পারফর্ম করব রিপোর্ট হাইজেনবাগ 2020 পিটার সম্মেলনে। পরীক্ষার ডেটা প্রস্তুত করার সময় কীভাবে ভুলগুলি এড়াতে হয় তা আমি আপনাকে বলব না, তবে জাভা অ্যাপ্লিকেশনগুলিতে ডেটা সেটগুলির সাথে কাজ করার আমার গোপনীয়তাগুলিও শেয়ার করব!

উত্স: www.habr.com