모바일 CICD 경험: 다양한 모바일 애플리케이션을 위한 하나의 fastlane 표준

fastlane을 사용하는 모바일 앱의 지속적인 통합과 전달에 대해 이야기하고 싶습니다. 모든 모바일 애플리케이션에 CI/CD를 구현한 방법, 그 목표에 도달한 방법 및 최종 결과는 무엇입니까?

도구의 네트워크에는 이미 충분한 자료가 있으므로 처음에는 부족했기 때문에 의도적으로 도구에 대해 자세히 설명하지 않고 당시에 가지고 있던 내용만 언급하겠습니다.

• 공식 fastlane 문서
• 다른 회사의 사례
• Fastlane을 사용하여 iOS 애플리케이션 조립을 자동화합니다.

이 기사는 두 부분으로 구성됩니다.

• 사내 모바일 CI/CD 등장 배경
• N 애플리케이션용 CI/CD 출시를 위한 기술 솔루션

첫 번째 부분은 옛날에 대한 향수를 더 많이 담고 있고, 두 번째 부분은 자신에게 적용할 수 있는 경험입니다.

역사적으로 그랬다.

2015 연도

우리는 방금 모바일 애플리케이션 개발을 시작했지만 지속적인 통합, DevOps 및 기타 최신 유행에 대해 아무것도 몰랐습니다. 각 애플리케이션 업데이트는 개발자가 자신의 컴퓨터에서 직접 출시했습니다. Android의 경우 매우 간단합니다. 조립, 서명 .apk Google 개발자 콘솔에 업로드한 다음 iOS의 경우 Xcode를 통한 배포 도구를 사용하여 즐거운 저녁을 보냈습니다. 아카이브를 다운로드하려는 시도는 종종 오류로 끝나서 다시 시도해야 했습니다. 가장 발전된 개발자는 한 달에 여러 번 코드를 작성하는 것이 아니라 애플리케이션을 출시하는 것으로 나타났습니다.

2016 연도

우리는 성장했고, 릴리스를 위해 하루 종일 개발자를 해방시키는 방법에 대해 이미 생각하고 있었고 두 번째 애플리케이션도 등장하여 우리를 자동화쪽으로 더 밀어 붙였습니다. 같은 해에 우리는 처음으로 Jenkins를 설치하고 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, 키 이름만 더 명확해졌습니다.

이번에는 gym과 내장된 xcpretty 포맷터 덕분에 빌드 로그를 훨씬 더 읽기 쉽게 만들었습니다. 이로 인해 깨진 어셈블리를 수정하는 데 드는 시간이 절약되기 시작했으며 때로는 릴리스 팀이 스스로 알아낼 수도 있었습니다.

불행하게도 조립 속도 측정 xcodebuild и gym 우리는 그렇게 하지 않았지만 문서를 신뢰할 것입니다. 속도가 최대 30% 향상됩니다.

모든 애플리케이션을 위한 단일 프로세스

2018년과 현재

2018년에는 애플리케이션을 구축하고 출시하는 프로세스가 Jenkins로 완전히 이전되었고 개발자는 머신에서 릴리스를 중단했으며 릴리스 팀만이 릴리스 권한을 가졌습니다.

우리는 이미 테스트 및 정적 분석 실행을 개선하고 싶었고 스크립트도 계속해서 성장했습니다. 우리의 애플리케이션과 함께 성장하고 변화했습니다. 당시 애플리케이션이 10개 정도 있었는데, 플랫폼이 20개 있다는 점을 고려하면 '살아있는' 스크립트가 XNUMX개 정도 된다.

스크립트에 새로운 단계를 추가하고 싶을 때마다 모든 셸 스크립트에 해당 부분을 복사하여 붙여넣어야 했습니다. 아마도 우리는 좀 더 신중하게 작업할 수 있었지만 그러한 변경 사항은 종종 오타로 끝나서 릴리스 팀이 스크립트를 수정하고 어떤 똑똑한 사람이 이 명령을 추가했는지, 실제로 무엇을 하는지 알아내는 데 저녁 시간이 걸렸습니다. 일반적으로 한 플랫폼의 어셈블리 스크립트가 적어도 다소 유사하다고 말할 수는 없습니다. 그들은 확실히 같은 일을 했지만.

새로운 애플리케이션에 대한 프로세스를 시작하려면 이러한 스크립트의 "새" 버전을 선택하고 디버깅한 후 "예, 작동합니다"라고 말하는 데 하루가 소요되었습니다.

2018년 여름, 우리는 다시 한 번 여전히 발전 중인 fastlane을 바라보았습니다.

작업 #1: 모든 스크립트 단계를 요약하고 Fastfile에 다시 작성합니다.

시작했을 때 스크립트는 Jenkins의 하나의 쉘 스크립트에 있는 모든 단계와 목발로 구성된 신발처럼 보였습니다. 아직 파이프라인과 단계별 분할로 전환하지 않았습니다.

우리는 현재 가지고 있는 것을 살펴보고 CI/CD 설명에 맞는 4가지 단계를 식별했습니다.

• 빌드 - 종속성 설치, 아카이브 조립,
• 테스트 — 개발자 단위 테스트 실행, 적용 범위 계산,
• sonar - 모든 린터를 실행하고 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

위의 예에서는 매개변수 중 일부만 지정해야 합니다. 이는 빌드 매개변수(스키마, 구성, 프로비저닝 프로필 이름) 및 배포 매개변수(개발자 계정의 Apple ID, 비밀번호, 애플리케이션 ID 등)입니다. 에. 첫 번째 근사치로 우리는 이러한 모든 키를 특수 파일에 넣습니다. Gymfile, Matchfile и Appfile.

이제 Jenkins에서는 보기를 흐리게 하지 않고 눈으로 쉽게 읽을 수 있는 짧은 명령을 호출할 수 있습니다.

# fastlane ios <lane_name>

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

만세, 우리는 훌륭해요

무엇을 얻었나요? 모든 단계에 대한 명령을 지웁니다. fastlane 파일에 깔끔하게 정리된 스크립트 정리. 기뻐하면서 우리는 개발자들에게 달려가서 저장소에 필요한 모든 것을 추가해 달라고 요청했습니다.

그러나 우리는 같은 어려움에 직면하게 될 것이라는 것을 시간이 지나면서 깨달았습니다. 어떤 식으로든 자신의 삶을 시작하는 20개의 어셈블리 스크립트가 여전히 남아 있을 것이고, 스크립트가 리포지토리로 이동하기 때문에 편집하기가 더 어려울 것입니다. 우리는 거기에 접근할 수 없었습니다. 그리고 일반적으로 이런 식으로 우리의 고통을 해결하는 것은 불가능합니다.

작업 #2: N개 애플리케이션에 대한 단일 Fastfile 가져오기

이제 문제를 해결하는 것이 그리 어렵지 않은 것 같습니다. 변수를 설정하고 진행해 보겠습니다. 네, 사실 그렇게 해서 문제가 해결됐어요. 그러나 우리가 문제를 해결한 순간 우리는 fastlane 자체에 대한 전문 지식도, fastlane이 작성된 Ruby에 대한 전문 지식도, 네트워크에 대한 유용한 예제도 없었습니다. 당시 fastlane에 대해 쓴 모든 사람은 하나의 애플리케이션에 대한 예제로 제한되었습니다. 개발자 한 명.

Fastlane은 환경 변수를 처리할 수 있으며 우리는 이미 키체인 비밀번호를 설정하여 이를 시도했습니다.

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.

릴리스 팀이 새로운 단계를 추가하려고 할 때 스크립트의 변경 사항은 git의 MR을 통해 기록되므로 더 이상 손상된 스크립트의 원인을 찾을 필요가 없으며 일반적으로 이제 이를 깨려고 시도해야 합니다.

이제 그게 확실해

이전에는 모든 스크립트를 유지 관리하고, 업데이트하고, 업데이트의 모든 결과를 수정하는 데 시간을 보냈습니다. 릴리스 오류와 다운타임의 원인이 뒤죽박죽된 쉘 스크립트에서 추적하기가 너무 어려운 단순한 오타였을 때 매우 실망스러웠습니다. 이제 이러한 오류가 최소화되었습니다. 변경 사항은 모든 애플리케이션에 동시에 적용됩니다. 그리고 새 애플리케이션을 프로세스에 추가하는 데 15분이 걸립니다. CI에 템플릿 파이프라인을 설정하고 개발자 저장소에 키를 추가합니다.

Android용 Fastfile과 애플리케이션 서명에 대한 요점은 여전히 ​​설명되지 않은 것 같습니다. 기사가 흥미로우면 계속 작성하겠습니다. 댓글이나 텔레그램에서 "이 문제를 어떻게 해결하시겠습니까?"에 대한 질문이나 제안을 보고 기쁘게 생각합니다. 바시키로바.

출처 : habr.com