მობილური CICD გამოცდილება: ერთი სწრაფი სტანდარტი მრავალი მობილური აპლიკაციისთვის

მსურს ვისაუბრო მობილური აპლიკაციების უწყვეტ ინტეგრაციასა და მიწოდებაზე fastlane-ის გამოყენებით. როგორ ვახორციელებთ CI/CD-ს ყველა მობილურ აპლიკაციაზე, როგორ მივედით იქ და რა მოხდა ბოლოს.

ქსელში უკვე არის საკმარისი მასალა ხელსაწყოზე, რომელიც ასე გვაკლდა დასაწყისში, ამიტომ შეგნებულად არ აღვწერ ხელსაწყოს დეტალურად, მაგრამ მხოლოდ მივმართავ იმას, რაც მაშინ გვქონდა:

• ოფიციალური fastlane დოკუმენტაცია
• მაგალითები სხვა კომპანიებიდან
• ჩვენ ავტომატიზირებს iOS აპლიკაციების შეკრებას Fastlane-ის გამოყენებით

სტატია შედგება ორი ნაწილისაგან:

• კომპანიაში მობილური CI/CD-ის გაჩენის ფონი
• ტექნიკური გადაწყვეტა CI/CD-ის გასაშლელად N-აპლიკაციებისთვის

პირველი ნაწილი უფრო ძველი დროის ნოსტალგიაა, მეორე კი გამოცდილება, რომელიც შეგიძლიათ საკუთარ თავს მიმართოთ.

ასე მოხდა ისტორიულად

წელი 2015

ჩვენ ახლახან დავიწყეთ მობილური აპლიკაციების შემუშავება, შემდეგ არაფერი ვიცოდით უწყვეტი ინტეგრაციის, DevOps-ის და სხვა მოდური ნივთების შესახებ. აპლიკაციის თითოეული განახლება გამოუშვა თავად დეველოპერმა თავისი კომპიუტერიდან. და თუ Android-ისთვის ეს საკმაოდ მარტივია - აწყობილი, ხელმოწერილი .apk და ატვირთა იგი Google Developer Console-ში, შემდეგ iOS-ისთვის Xcode-ის შემდეგ გავრცელების ხელსაწყო დაგვიტოვა შესანიშნავი საღამოები - არქივის ჩამოტვირთვის მცდელობები ხშირად მთავრდებოდა შეცდომით და გვიწევდა ხელახლა ცდა. აღმოჩნდა, რომ ყველაზე მოწინავე დეველოპერი თვეში რამდენჯერმე არ წერს კოდს, არამედ ავრცელებს აპლიკაციას.

წელი 2016

გავიზარდეთ, უკვე გვქონდა ფიქრები იმის შესახებ, თუ როგორ უნდა გაგვეთავისუფლა დეველოპერები გამოშვებისთვის მთელი დღიდან და გამოჩნდა მეორე აპლიკაციაც, რომელმაც მხოლოდ ავტომატიზაციისკენ მიბიძგა. იმავე წელს ჩვენ პირველად დავაინსტალირეთ ჯენკინსი და დავწერეთ საშინელი სკრიპტების თაიგული, ძალიან გავს მათ, რასაც fastlane აჩვენებს თავის დოკუმენტაციაში.

$ 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

წელს გავიგეთ, რომ არსებობს ისეთი რამ, როგორიცაა fastlane. არ იყო იმდენი ინფორმაცია, რამდენიც ახლაა - როგორ დავიწყოთ, როგორ გამოვიყენო. და თავად ინსტრუმენტი იმ დროს ჯერ კიდევ უხეში იყო: მუდმივმა შეცდომებმა მხოლოდ იმედგაცრუება დაგვაკარგვინა და ძნელი დასაჯერებელი იყო იმ ჯადოსნური ავტომატიზაციისა, რომელსაც ისინი გვპირდებოდნენ.

თუმცა, ძირითადი კომუნალური საშუალებები შედის fastlane ბირთვში gym и pilot, ჩვენ მოვახერხეთ მისი დაწყება.

ჩვენი სკრიპტები ცოტათი გაუმჯობესდა.

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

ისინი გაუმჯობესდა, თუნდაც იმიტომ, რომ არ არის აუცილებელი ყველა პარამეტრი xcodebuild, თქვენ უნდა მიუთითოთ - gym დამოუკიდებლად გაიგებს სად და რა დევს. და მეტი დაზუსტებისთვის, შეგიძლიათ მიუთითოთ იგივე კლავიშები, როგორც აქ xcodebuild, მხოლოდ გასაღებების დასახელებაა უფრო ნათელი.

ამჯერად, სავარჯიშო დარბაზის და ჩაშენებული xcpretty ფორმატის წყალობით, build logs გახდა ბევრად უფრო იკითხება. ამან დაიწყო დროის დაზოგვა გატეხილი ასამბლეების შეკეთებაზე და ზოგჯერ გამოშვების გუნდს შეეძლო ამის გარკვევა დამოუკიდებლად.

სამწუხაროდ, შეკრების სიჩქარის გაზომვები xcodebuild и gym ჩვენ ეს არ გავაკეთეთ, მაგრამ ჩვენ ვენდობით დოკუმენტაციას - 30%-მდე სიჩქარე.

ერთი პროცესი ყველა განაცხადისთვის

2018 წელი და დღემდე

2018 წლისთვის, აპლიკაციების შექმნისა და გაშვების პროცესი მთლიანად გადავიდა ჯენკინსში, დეველოპერებმა შეწყვიტეს გამოშვება თავიანთი მანქანებიდან და მხოლოდ გამოშვების გუნდს ჰქონდა გაშვების უფლება.

ჩვენ უკვე გვინდოდა ტესტების და სტატიკური ანალიზის გაშვების გაუმჯობესება და ჩვენი სკრიპტები იზრდებოდა და იზრდებოდა. გაიზარდა და შეიცვალა ჩვენს აპლიკაციებთან ერთად. იმ დროს დაახლოებით 10 აპლიკაცია იყო, თუ გავითვალისწინებთ, რომ ჩვენ გვაქვს ორი პლატფორმა, ეს არის დაახლოებით 20 „ცოცხალი“ სკრიპტი.

ყოველ ჯერზე, როცა გვინდოდა სკრიპტში ახალი ნაბიჯის დამატება, გვიწევდა ნაწილების კოპირება-პასტეტი ყველა shell სკრიპტში. შესაძლოა, შეგვეძლო უფრო ფრთხილად გვემუშავა, მაგრამ ხშირად ასეთი ცვლილებები მთავრდებოდა ბეჭდვითი შეცდომით, რაც გამოშვების გუნდში გადაიზარდა საღამოებად, რათა გაესწორებინათ სკრიპტები და გაეგოთ, რომელმა ჭკვიანმა დაამატა ეს ბრძანება და რას აკეთებს ის სინამდვილეში. ზოგადად, არ შეიძლება ითქვას, რომ ერთი პლატფორმისთვის შეკრების სკრიპტები მაინც გარკვეულწილად მსგავსი იყო. მიუხედავად იმისა, რომ მათ, რა თქმა უნდა, იგივე გააკეთეს.

ახალი აპლიკაციის პროცესის დასაწყებად, საჭირო იყო ერთი დღის დახარჯვა ამ სკრიპტების „ახალი“ ვერსიის შესარჩევად, მისი გამართვისთვის და იმის თქმა, რომ „დიახ, მუშაობს“.

2018 წლის ზაფხულში ჩვენ კიდევ ერთხელ შევხედეთ ჯერ კიდევ განვითარებად სწრაფ ზოლს.

დავალება #1: შეაჯამეთ სკრიპტის ყველა ნაბიჯი და გადაწერეთ ისინი Fastfile-ში

როდესაც დავიწყეთ, ჩვენი სკრიპტები წააგავდა ფეხსაცმლის ქსოვილს, რომელიც შედგებოდა ყველა საფეხურისგან და ყავარჯნებისაგან ჯენკინსის ერთ გარსში. მილსადენზე და ეტაპობრივად დაყოფაზე ჯერ არ გადავედით.

ჩვენ გადავხედეთ რა გვაქვს და გამოვავლინეთ 4 ნაბიჯი, რომელიც შეესაბამება ჩვენი CI/CD-ის აღწერას:

• აშენება - დამოკიდებულებების დაყენება, არქივის აწყობა,
• ტესტი - დეველოპერის ერთეულის ტესტების გაშვება, დაფარვის გამოთვლა,
• სონარი - უშვებს ყველა ლინტერს და აგზავნის მოხსენებებს SonarQube-ს,
• განლაგება — არტეფაქტის გაგზავნა ალფაზე (TestFlight).

და თუ დეტალებში არ შედიხართ, მოქმედებებში გამოყენებული გასაღებების გამოტოვებით, მიიღებთ ამ Fastfile-ს:

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

სინამდვილეში, ჩვენი პირველი Fastfile აღმოჩნდა ამაზრზენი, თუ გავითვალისწინებთ ზოგიერთ ხელჯოხებს, რომლებიც ჯერ კიდევ გვჭირდებოდა და იმ პარამეტრების რაოდენობას, რომლებიც ჩავანაცვლეთ:

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

ზემოთ მოყვანილ მაგალითში, მხოლოდ იმ პარამეტრების ნაწილია, რომელიც უნდა დავაკონკრეტოთ: ეს არის build-ის პარამეტრები - სქემა, კონფიგურაცია, პროფილების სახელები, ასევე განაწილების პარამეტრები - დეველოპერის ანგარიშის Apple ID, პაროლი, აპლიკაციის ID და ა.შ. on. როგორც პირველი მიახლოება, ჩვენ ყველა ამ კლავიშს ვდებთ სპეციალურ ფაილებში - Gymfile, Matchfile и Appfile.

ახლა ჯენკინსში შეგიძლიათ დარეკოთ მოკლე ბრძანებები, რომლებიც არ აბუნდოვანებენ ხედს და ადვილად იკითხება თვალით:

# fastlane ios <lane_name>

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

ჰური, მშვენივრად ვართ

Რა მიიღე? გაასუფთავეთ ბრძანებები ყოველი ნაბიჯისთვის. გასუფთავებული სკრიპტები, ლამაზად დალაგებული fastlane ფაილებში. გახარებულები გავიქეცით დეველოპერებთან და ვთხოვეთ, დაემატებინათ ყველაფერი, რაც მათ სჭირდებოდათ თავიანთ საცავებში.

მაგრამ ჩვენ დროულად მივხვდით, რომ იგივე სირთულეები შეგვექმნება - ჩვენ მაინც გვექნებოდა 20 ასამბლეის სკრიპტი, რომლებიც ასე თუ ისე დაიწყებდნენ საკუთარ ცხოვრებას, უფრო რთული იქნებოდა მათი რედაქტირება, რადგან სკრიპტები გადავიდოდა საცავებში, და იქ არ გვქონდა წვდომა. და საერთოდ, ჩვენი ტკივილის ასე გადაჭრა არ იქნება.

დავალება #2: მიიღეთ ერთი Fastfile N აპლიკაციისთვის

ახლა, როგორც ჩანს, პრობლემის გადაჭრა არც ისე რთულია - დააყენეთ ცვლადები და მოდით წავიდეთ. დიახ, ფაქტობრივად, ასე მოგვარდა პრობლემა. მაგრამ იმ მომენტში, როდესაც ჩვენ გავაფუჭეთ, ჩვენ არ გვქონდა არც გამოცდილება თავად fastlane-ში, არც Ruby-ში, რომელშიც fastlane არის დაწერილი, არც სასარგებლო მაგალითები ქსელში - ყველა, ვინც მაშინ წერდა fastlane-ზე, შემოიფარგლებოდა მაგალითით ერთი განაცხადისთვის. ერთი დეველოპერი.

Fastlane-ს შეუძლია გარემოს ცვლადების მართვა და ჩვენ უკვე ვცადეთ ეს Keychain პაროლის დაყენებით:

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

ახლა, იმისათვის, რომ დაგვეწყო ამ კლავიშების გამოყენება fastlane ფაილებში, უნდა გაერკვია, როგორ მიგვეტანა ისინი იქ. Fastlane-ს აქვს გამოსავალი ამისთვის: ცვლადების ჩატვირთვა dotenv-ის საშუალებით. დოკუმენტაციაში ნათქვამია, რომ თუ თქვენთვის მნიშვნელოვანია გასაღებების ჩატვირთვა სხვადასხვა მიზნებისთვის, შექმენით რამდენიმე კონფიგურაციის ფაილი fastlane დირექტორიაში. .env, .env.default, .env.development.

შემდეგ კი გადავწყვიტეთ, რომ ეს ბიბლიოთეკა ცოტა განსხვავებულად გამოგვეყენებინა. მოდით, დეველოპერების საცავში განვათავსოთ არა fastlane სკრიპტები და მისი მეტა ინფორმაცია, არამედ ამ აპლიკაციის უნიკალური გასაღებები ფაილში. .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

ეს გადაწყვეტა დარჩა, თუმცა Fastlane-ს აქვს გამოსავალი Fastfile-ის საშუალებით ჩამოტვირთვისთვის აქცია import_from_git, მაგრამ მუშაობს მხოლოდ Fastfile-ზე, მაგრამ არა სხვა ფაილებზე. თუ გსურთ "ნამდვილად ლამაზი", შეგიძლიათ დაწეროთ საკუთარი action.

მსგავსი ნაკრები გაკეთდა Android აპლიკაციებისთვის და ReactNative-ისთვის, ფაილები არის იმავე საცავში, მაგრამ სხვადასხვა ფილიალში iOS, android и react_native.

როდესაც გამოშვების გუნდს სურს რაიმე ახალი ნაბიჯის დამატება, ცვლილებები სკრიპტში ჩაიწერება MR-ის საშუალებით git-ში, აღარ არის საჭირო გატეხილი სკრიპტების დამნაშავეების ძებნა და ზოგადად, ახლა თქვენ უნდა სცადოთ მისი გატეხვა.

ახლა ეს ნამდვილად არის

ადრე ჩვენ ვხარჯავდით ყველა სკრიპტის შენარჩუნებას, მათ განახლებას და განახლებების ყველა შედეგის გამოსწორებას. ძალიან იმედგაცრუებული იყო, როდესაც გამოშვებებში შეცდომებისა და შეფერხების მიზეზები იყო მარტივი ბეჭდვითი შეცდომები, რომელთა თვალყურის დევნება ძალიან რთული იყო ჭურვის სკრიპტების აურზაურში. ახლა ასეთი შეცდომები მინიმუმამდეა დაყვანილი. ცვლილებები ერთდროულად ვრცელდება ყველა აპლიკაციაში. და 15 წუთი სჭირდება ახალი აპლიკაციის პროცესში - დააყენეთ შაბლონის მილსადენი CI-ზე და დაამატეთ გასაღებები დეველოპერის საცავში.

როგორც ჩანს, Fastfile for Android-ისთვის და აპლიკაციის ხელმოწერა აუხსნელი რჩება, თუ სტატია საინტერესოა, გაგრძელებას დავწერ. სიამოვნებით ვნახავ თქვენს კითხვებს ან წინადადებებს „როგორ მოაგვარებდით ამ პრობლემას“ კომენტარებში ან Telegram-ში ბაშიროვა.

წყარო: www.habr.com