મોબાઇલ CICD અનુભવ: ઘણી મોબાઇલ એપ્લિકેશન્સ માટે એક ફાસ્ટલેન સ્ટાન્ડર્ડ

હું ફાસ્ટલેનનો ઉપયોગ કરીને મોબાઇલ એપ્લિકેશન્સ માટે સતત એકીકરણ અને વિતરણ વિશે વાત કરવા માંગુ છું. અમે તમામ મોબાઇલ એપ્લિકેશન્સ પર CI/CD કેવી રીતે લાગુ કરીએ છીએ, અમે ત્યાં કેવી રીતે પહોંચ્યા અને અંતે શું થયું.

ટૂલ પરના નેટવર્ક પર પહેલેથી જ પૂરતી સામગ્રી છે, જેનો અમારી પાસે શરૂઆતમાં અભાવ હતો, તેથી હું ઇરાદાપૂર્વક ટૂલનું વિગતવાર વર્ણન કરીશ નહીં, પરંતુ તે સમયે અમારી પાસે જે હતું તેનો જ સંદર્ભ આપીશ:

• અધિકૃત ફાસ્ટલેન દસ્તાવેજીકરણ
• અન્ય કંપનીઓના ઉદાહરણો
• અમે ફાસ્ટલેનનો ઉપયોગ કરીને iOS એપ્લિકેશનની એસેમ્બલીને સ્વચાલિત કરીએ છીએ

લેખમાં બે ભાગો છે:

• કંપનીમાં મોબાઈલ સીઆઈ/સીડીના ઉદભવની પૃષ્ઠભૂમિ
• એન-એપ્લિકેશન માટે CI/CD રોલ આઉટ કરવા માટે ટેકનિકલ સોલ્યુશન

પ્રથમ ભાગ જૂના દિવસો માટે વધુ નોસ્ટાલ્જિયા છે, અને બીજો એક અનુભવ છે જે તમે તમારી જાતને લાગુ કરી શકો છો.

ઐતિહાસિક રીતે આ રીતે થયું

વર્ષ 2015

અમે હમણાં જ મોબાઇલ એપ્લિકેશનો વિકસાવવાનું શરૂ કર્યું, પછી અમને સતત એકીકરણ વિશે, DevOps અને અન્ય ફેશનેબલ વસ્તુઓ વિશે કંઈપણ ખબર ન હતી. દરેક એપ્લીકેશન અપડેટ ડેવલપર દ્વારા પોતે તેના મશીનમાંથી રોલઆઉટ કરવામાં આવી હતી. અને જો Android માટે તે એકદમ સરળ છે - એસેમ્બલ, સહી કરેલ .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

ઉપરના ઉદાહરણમાં, પરિમાણોનો માત્ર એક ભાગ જે આપણે સ્પષ્ટ કરવાની જરૂર છે: આ બિલ્ડ પરિમાણો છે - સ્કીમા, રૂપરેખાંકન, જોગવાઈ પ્રોફાઇલ નામો, તેમજ વિતરણ પરિમાણો - વિકાસકર્તા એકાઉન્ટનું Apple ID, પાસવર્ડ, એપ્લિકેશન ID, અને તેથી પર પ્રથમ અંદાજ તરીકે, અમે આ બધી કીને વિશિષ્ટ ફાઇલોમાં મૂકીએ છીએ - 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, પરંતુ તે માત્ર Fastfile માટે કામ કરે છે, પરંતુ અન્ય ફાઇલો માટે નહીં. જો તમે "ખરેખર સુંદર" ઈચ્છો છો, તો તમે તમારું પોતાનું લખી શકો છો action.

એન્ડ્રોઇડ એપ્લિકેશન્સ અને રીએક્ટનેટીવ માટે સમાન સેટ બનાવવામાં આવ્યો હતો, ફાઇલો એક જ ભંડારમાં છે, પરંતુ વિવિધ શાખાઓમાં iOS, android и react_native.

જ્યારે રીલીઝ ટીમ કેટલાક નવા પગલા ઉમેરવા માંગે છે, ત્યારે સ્ક્રિપ્ટમાં ફેરફારો MR દ્વારા git માં રેકોર્ડ કરવામાં આવે છે, હવે તૂટેલી સ્ક્રિપ્ટના ગુનેગારોને શોધવાની કોઈ જરૂર નથી, અને સામાન્ય રીતે, હવે તમારે તેને તોડવાનો પ્રયાસ કરવો પડશે.

હવે તે ખાતરી માટે છે

અગાઉ, અમે બધી સ્ક્રિપ્ટોને જાળવવામાં, તેમને અપડેટ કરવામાં અને અપડેટ્સના તમામ પરિણામોને ઠીક કરવામાં સમય પસાર કર્યો હતો. તે ખૂબ જ નિરાશાજનક હતું જ્યારે રીલીઝમાં ભૂલો અને ડાઉનટાઇમના કારણો સરળ ટાઇપોસ હતા જે શેલ સ્ક્રિપ્ટ્સના ગૂંચવણમાં ટ્રેક રાખવા માટે ખૂબ મુશ્કેલ હતા. હવે આવી ભૂલો ન્યૂનતમ થઈ ગઈ છે. ફેરફારો એક જ સમયે તમામ એપ્લિકેશનોમાં રોલઆઉટ કરવામાં આવે છે. અને પ્રક્રિયામાં નવી એપ્લિકેશન મૂકવા માટે 15 મિનિટ લાગે છે - CI પર ટેમ્પલેટ પાઇપલાઇન સેટ કરો અને વિકાસકર્તાના ભંડારમાં કી ઉમેરો.

એવું લાગે છે કે Android અને એપ્લિકેશન હસ્તાક્ષર માટે ફાસ્ટફાઇલ સાથેનો મુદ્દો અસ્પષ્ટ રહે છે; જો લેખ રસપ્રદ છે, તો હું એક ચાલુ લખીશ. ટિપ્પણીઓમાં અથવા ટેલિગ્રામ પર "તમે આ સમસ્યાને કેવી રીતે હલ કરશો" તમારા પ્રશ્નો અથવા સૂચનો જોઈને મને આનંદ થશે બશ્કીરોવા.

સોર્સ: www.habr.com