মোবাইল CICD অভিজ্ঞতা: অনেক মোবাইল অ্যাপ্লিকেশনের জন্য একটি ফাস্টলেন স্ট্যান্ডার্ড

আমি ফাস্টলেন ব্যবহার করে মোবাইল অ্যাপ্লিকেশানগুলির জন্য ক্রমাগত একীকরণ এবং বিতরণ সম্পর্কে কথা বলতে চাই৷ আমরা কীভাবে সমস্ত মোবাইল অ্যাপ্লিকেশনে CI/CD প্রয়োগ করি, কীভাবে আমরা সেখানে পৌঁছলাম এবং শেষ পর্যন্ত কী ঘটেছিল।

টুলটির নেটওয়ার্কে ইতিমধ্যে পর্যাপ্ত উপাদান রয়েছে, যার শুরুতে আমাদের অভাব ছিল, তাই আমি ইচ্ছাকৃতভাবে সরঞ্জামটি বিশদভাবে বর্ণনা করব না, তবে কেবল তখনই আমাদের যা ছিল তা উল্লেখ করব:

• অফিসিয়াল ফাস্টলেন ডকুমেন্টেশন
• অন্যান্য কোম্পানি থেকে উদাহরণ
• আমরা ফাস্টলেন ব্যবহার করে iOS অ্যাপ্লিকেশনগুলির সমাবেশ স্বয়ংক্রিয় করি

নিবন্ধটি দুটি অংশ নিয়ে গঠিত:

• কোম্পানিতে মোবাইল সিআই/সিডির উত্থানের পটভূমি
• এন-অ্যাপ্লিকেশনের জন্য CI/CD রোল আউট করার জন্য প্রযুক্তিগত সমাধান

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

ঐতিহাসিকভাবে তাই ঘটেছে

2015 বছর

আমরা সবেমাত্র মোবাইল অ্যাপ্লিকেশন ডেভেলপ করা শুরু করেছি, তারপর আমরা ক্রমাগত ইন্টিগ্রেশন, DevOps এবং অন্যান্য ফ্যাশনেবল জিনিস সম্পর্কে কিছুই জানতাম না। প্রতিটি অ্যাপ্লিকেশন আপডেট ডেভেলপার নিজেই তার মেশিন থেকে রোল আউট করেছিলেন। এবং যদি অ্যান্ড্রয়েডের জন্য এটি বেশ সহজ - একত্রিত, স্বাক্ষরিত .apk এবং এটি Google ডেভেলপার কনসোলে আপলোড করে, তারপরে iOS-এর জন্য Xcode-এর মাধ্যমে তৎকালীন ডিস্ট্রিবিউশন টুলটি আমাদের দুর্দান্ত সন্ধ্যায় ফেলে দেয় - সংরক্ষণাগারটি ডাউনলোড করার প্রচেষ্টা প্রায়শই ত্রুটিতে শেষ হয় এবং আমাদের আবার চেষ্টা করতে হয়। দেখা গেল যে সবচেয়ে উন্নত বিকাশকারী মাসে কয়েকবার কোড লেখেন না, বরং অ্যাপ্লিকেশনটি প্রকাশ করেন।

2016 বছর

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

$ xcodebuild clean archive -archivePath build/MyApp 
    -scheme MyApp

$ xcodebuild -exportArchive 
                        -exportFormat ipa 
                        -archivePath "build/MyApp.xcarchive" 
                        -exportPath "build/MyApp.ipa" 
                        -exportProvisioningProfile "ProvisioningProfileName"

$ cd /Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/

$ ./altool —upload-app 
-f {abs path to your project}/build/{release scheme}.ipa  
-u "[email protected]" 
-p "PASS_APPLE_ID"

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

2017 বছর

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

যাইহোক, ফাস্টলেন কোর অন্তর্ভুক্ত প্রধান ইউটিলিটি হয় gym и pilot, আমরা এটি শুরু করতে পেরেছি।

আমাদের স্ক্রিপ্ট একটু উন্নত করা হয়েছে.

$ fastlane gym  —-workspace "Example.xcworkspace" 
                --scheme "AppName" 
                —-buildlog_path "/tmp" 
                -—clean

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

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

দুর্ভাগ্যবশত, সমাবেশ গতি পরিমাপ xcodebuild и gym আমরা এটি করিনি, তবে আমরা ডকুমেন্টেশনে বিশ্বাস করব - 30% পর্যন্ত গতি।

সমস্ত অ্যাপ্লিকেশনের জন্য একক প্রক্রিয়া

2018 সাল এবং বর্তমান

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

আমরা ইতিমধ্যে পরীক্ষা এবং স্ট্যাটিক বিশ্লেষণ চালু করতে চেয়েছিলাম এবং আমাদের স্ক্রিপ্টগুলি বেড়েছে এবং বেড়েছে। আমাদের অ্যাপ্লিকেশনের সাথে বৃদ্ধি এবং পরিবর্তিত হয়েছে। সেই সময়ে, প্রায় 10টি অ্যাপ্লিকেশন ছিল৷ আমাদের দুটি প্ল্যাটফর্ম আছে তা বিবেচনা করে, এটি প্রায় 20টি "জীবিত" স্ক্রিপ্ট৷

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

একটি নতুন অ্যাপ্লিকেশনের জন্য একটি প্রক্রিয়া শুরু করার জন্য, এই স্ক্রিপ্টগুলির একটি "নতুন" সংস্করণ নির্বাচন করতে, এটিকে ডিবাগ করতে এবং "হ্যাঁ, এটি কাজ করে" বলতে একটি দিন ব্যয় করতে হয়েছিল৷

2018 সালের গ্রীষ্মে, আমরা আবারও উন্নয়নশীল ফাস্টলেনের দিকে তাকিয়েছিলাম।

টাস্ক #1: সমস্ত স্ক্রিপ্টের ধাপগুলিকে সংক্ষিপ্ত করুন এবং সেগুলিকে ফাস্টফাইলে পুনরায় লিখুন৷

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

আমরা আমাদের কাছে যা আছে তা দেখেছি এবং আমাদের CI/CD এর বর্ণনার সাথে মানানসই 4টি ধাপ চিহ্নিত করেছি:

• নির্মাণ - নির্ভরতা ইনস্টল করা, সংরক্ষণাগার একত্রিত করা,
• পরীক্ষা — বিকাশকারী ইউনিট পরীক্ষা চালানো, কভারেজ গণনা করা,
• সোনার - সমস্ত লিন্টার চালু করে এবং সোনারকিউবে রিপোর্ট পাঠায়,
• স্থাপন করুন — আলফা (টেস্টফ্লাইট) এ একটি আর্টিফ্যাক্ট পাঠানো।

এবং যদি আপনি বিশদে না যান, অ্যাকশনে ব্যবহৃত কীগুলি বাদ দিয়ে, আপনি এই ফাস্টফাইলটি পাবেন:

default_platform(:ios)

platform :ios do
  before_all do
    unlock
  end

  desc "Build stage"
  lane :build do
    match
    prepare_build
    gym
  end

  desc "Prepare build stage: carthage and cocoapods"
  lane :prepare_build do
    pathCartfile = ""
    Dir.chdir("..") do
      pathCartfile = File.join(Dir.pwd, "/Cartfile")
    end
    if File.exist?(pathCartfile)
      carthage
    end
    pathPodfile = ""
    Dir.chdir("..") do
      pathPodfile = File.join(Dir.pwd, "/Podfile")
    end
    if File.exist?(pathPodfile)
      cocoapods
    end
  end

  desc "Test stage"
  lane :test do
    scan
    xcov
  end

  desc "Sonar stage (after run test!)"
  lane :run_sonar do
    slather
    lizard
    swiftlint
    sonar
  end

  desc "Deploy to testflight stage"
  lane :deploy do
    pilot
  end

  desc "Unlock keychain"
  private_lane :unlock do
    pass = ENV['KEYCHAIN_PASSWORD']
    unlock_keychain(
      password: pass
    )
  end
end

প্রকৃতপক্ষে, আমাদের প্রথম ফাস্টফাইল ভয়ঙ্কর হয়ে উঠেছে, আমাদের এখনও প্রয়োজনীয় কিছু ক্রাচ এবং আমরা প্রতিস্থাপিত প্যারামিটারের সংখ্যা বিবেচনা করে:

lane :build do
carthage(
  command: "update",
  use_binaries: false,
  platform: "ios",
  cache_builds: true)
cocoapods(
  clean: true,
    podfile: "./Podfile",
    use_bundle_exec: false)

gym(
  workspace: "MyApp.xcworkspace",
  configuration: "Release",
  scheme: "MyApp",
  clean: true,
  output_directory: "/build",
  output_name: "my-app.ipa")
end 

lane :deploy do
 pilot(
  username: "[email protected]",
  app_identifier: "com.example.app",
  dev_portal_team_id: "TEAM_ID_NUMBER_DEV",
  team_id: "ITS_TEAM_ID")
end

উপরের উদাহরণে, শুধুমাত্র প্যারামিটারগুলির একটি অংশ যা আমাদের নির্দিষ্ট করতে হবে: এগুলি হল বিল্ড প্যারামিটার - স্কিমা, কনফিগারেশন, প্রোভিশন প্রোফাইলের নাম, সেইসাথে ডিস্ট্রিবিউশন প্যারামিটার - ডেভেলপার অ্যাকাউন্টের অ্যাপল আইডি, পাসওয়ার্ড, অ্যাপ্লিকেশন আইডি এবং তাই চালু. প্রথম আনুমানিক হিসাবে, আমরা এই সমস্ত কীগুলি বিশেষ ফাইলগুলিতে রাখি - Gymfile, Matchfile и Appfile.

এখন জেনকিন্সে আপনি সংক্ষিপ্ত কমান্ডগুলি কল করতে পারেন যা দৃশ্যটিকে অস্পষ্ট করে না এবং চোখের দ্বারা সহজেই পঠনযোগ্য:

# fastlane ios <lane_name>

$ fastlane ios build
$ fastlane ios test
$ fastlane ios run_sonar
$ fastlane ios deploy

হুররে, আমরা দুর্দান্ত

তুমি কি পেলে? প্রতিটি পদক্ষেপের জন্য সাফ কমান্ড. স্ক্রিপ্টগুলি পরিষ্কার করা, ফাস্টলেন ফাইলগুলিতে সুন্দরভাবে সাজানো। আনন্দের সাথে, আমরা ডেভেলপারদের কাছে ছুটে যাই তাদের সংগ্রহস্থলে তাদের প্রয়োজনীয় সবকিছু যোগ করতে বলে।

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

টাস্ক #2: N অ্যাপ্লিকেশনের জন্য একটি একক ফাস্টফাইল পান

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

ফাস্টলেন এনভায়রনমেন্ট ভেরিয়েবলগুলি পরিচালনা করতে পারে এবং আমরা ইতিমধ্যে কীচেন পাসওয়ার্ড সেট করে এটি চেষ্টা করেছি:

ENV['KEYCHAIN_PASSWORD']

আমাদের স্ক্রিপ্টগুলি দেখার পরে, আমরা সাধারণ অংশগুলি চিহ্নিত করেছি:

#for build, test and deploy
APPLICATION_SCHEME_NAME=appScheme
APPLICATION_PROJECT_NAME=app.xcodeproj
APPLICATION_WORKSPACE_NAME=app.xcworkspace
APPLICATION_NAME=appName

OUTPUT_IPA_NAME=appName.ipa

#app info
APP_BUNDLE_IDENTIFIER=com.example.appName
[email protected]
TEAM_ID=ABCD1234
FASTLANE_ITC_TEAM_ID=123456789

এখন, ফাস্টলেন ফাইলগুলিতে এই কীগুলি ব্যবহার করা শুরু করার জন্য, আমাদের সেখানে কীভাবে সরবরাহ করা যায় তা খুঁজে বের করতে হয়েছিল। ফাস্টলেন এর জন্য একটি সমাধান আছে: dotenv এর মাধ্যমে ভেরিয়েবল লোড করা হচ্ছে. ডকুমেন্টেশন বলছে যে বিভিন্ন উদ্দেশ্যে কী লোড করা আপনার জন্য গুরুত্বপূর্ণ হলে, ফাস্টলেন ডিরেক্টরিতে বেশ কয়েকটি কনফিগারেশন ফাইল তৈরি করুন .env, .env.default, .env.development.

এবং তারপর আমরা একটু ভিন্নভাবে এই লাইব্রেরি ব্যবহার করার সিদ্ধান্ত নিয়েছে. ডেভেলপারদের সংগ্রহস্থলে ফাস্টলেন স্ক্রিপ্ট এবং এর মেটা তথ্য নয়, ফাইলটিতে এই অ্যাপ্লিকেশনটির অনন্য কীগুলি রাখুন .env.appName.

নিজেদের Fastfile, Appfile, Matchfile и Gymfile, আমরা এটি একটি পৃথক সংগ্রহস্থলে লুকিয়ে রেখেছি। অন্যান্য পরিষেবার পাসওয়ার্ড কী সহ একটি অতিরিক্ত ফাইল সেখানে লুকানো ছিল - .env.
আপনি একটি উদাহরণ দেখতে পারেন এখানে.

CI-তে, কলটি খুব বেশি পরিবর্তিত হয়নি; একটি নির্দিষ্ট অ্যাপ্লিকেশনের জন্য একটি কনফিগারেশন কী যোগ করা হয়েছে:

# fastlane ios <lane_name> --env appName

$ fastlane ios build --env appName
$ fastlane ios test --env appName
$ fastlane ios run_sonar --env appName
$ fastlane ios deploy --env appName

কমান্ড চালানোর আগে, আমরা স্ক্রিপ্ট সহ আমাদের সংগ্রহস্থল লোড করি। এত সুন্দর দেখাচ্ছে না:

git clone [email protected]/FastlaneCICD.git fastlane_temp

cp ./fastlane_temp/fastlane/* ./fastlane/
cp ./fastlane_temp/fastlane/.env fastlane/.env

আপাতত এই সমাধানটি ছেড়ে দিয়েছি, যদিও ফাস্টলেনের মাধ্যমে ফাস্টফাইল ডাউনলোড করার জন্য একটি সমাধান রয়েছে কর্ম import_from_git, কিন্তু এটি শুধুমাত্র ফাস্টফাইলের জন্য কাজ করে, কিন্তু অন্যান্য ফাইলের জন্য নয়। আপনি যদি "সত্যিই সুন্দর" চান তবে আপনি নিজের লিখতে পারেন action.

একটি অনুরূপ সেট অ্যান্ড্রয়েড অ্যাপ্লিকেশন এবং ReactNative জন্য তৈরি করা হয়েছিল, ফাইলগুলি একই সংগ্রহস্থলে, কিন্তু বিভিন্ন শাখায় iOS, android и react_native.

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

এখন এটা নিশ্চিত

পূর্বে, আমরা সমস্ত স্ক্রিপ্ট রক্ষণাবেক্ষণ, সেগুলি আপডেট করতে এবং আপডেটের সমস্ত পরিণতি ঠিক করতে সময় ব্যয় করেছি। এটি খুবই হতাশাজনক ছিল যখন রিলিজে ত্রুটি এবং ডাউনটাইমের কারণগুলি ছিল সাধারণ টাইপো যা শেল স্ক্রিপ্টের গোলমালের মধ্যে ট্র্যাক রাখা এত কঠিন ছিল। এখন এই ধরনের ত্রুটি একটি সর্বনিম্ন হ্রাস করা হয়. পরিবর্তনগুলি একবারে সমস্ত অ্যাপ্লিকেশনগুলিতে রোল আউট করা হয়৷ এবং প্রক্রিয়াটিতে একটি নতুন অ্যাপ্লিকেশন আনতে 15 মিনিট সময় লাগে - CI-এ একটি টেমপ্লেট পাইপলাইন সেট আপ করুন এবং বিকাশকারীর সংগ্রহস্থলে কীগুলি যুক্ত করুন৷

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

উত্স: www.habr.com