GitLab CI
Tuist Runners ამჟამად მხოლოდ მიწვევითაა ხელმისაწვდომი. დაგვიკავშირდით ან მოგვწერეთ საზოგადოების Slack-ში, რათა თქვენი ანგარიშისთვის წვდომა მოითხოვოთ.
თქვენი პაიპლაინები რჩება GitLab-ში. Tuist უზრუნველყოფს იზოლირებულ Linux ან macOS მანქანას თითოეული ჯობისთვის და აგზავნის მის ლოგებსა და შედეგებს GitLab-ში და Tuist-ის დაშბორდზე. საჭიროა GitLab 19.3 ან უფრო ახალი ვერსია. მხარდაჭერილია GitLab.com და საჯარო HTTPS-ით ხელმისაწვდომი თვითმართვადი ინსტანციები.
-
შექმენით GitLab-ის რანერი. თქვენი პროექტის Settings → CI/CD → Runners განყოფილებაში შექმენით პროექტის რანერი. ასევე შეგიძლიათ გამოიყენოთ ჯგუფური რანერი. დაამატეთ ყველა Tuist-ის პროფილის ლეიბლი, რომელთა გამოყენებაც გსურთ რანერის ტეგებად, მაგალითად
tuist-linuxდაtuist-macos, და გააუქმეთ Run untagged jobs. შეინახეთ GitLab-ის მიერ ნაჩვენები ავტორიზაციის ტოკენი, რომელიც იწყებაglrt--ით. არ არის საჭირო რანერის დაყენება თქვენს საკუთარ მანქანაზე. -
ერთხელ დააკავშირეთ Tuist-თან. Settings → Integrations განყოფილებაში, GitLab CI ბარათზე აირჩიეთ Connect. შეიყვანეთ თქვენი GitLab URL და რანერის ავტორიზაციის ტოკენი. კავშირს შეუძლია მოემსახუროს ჯობებს სხვადასხვა პროფილებით. ტოკენები ინახება დაშიფრული და აღარასდროს ჩანს. სურვილისამებრ, დაამატეთ API წვდომის ტოკენი, რათა merge request პაიპლაინებმა შეძლონ ქეშის ტომების შენახვა; იხილეთ Merge request pipelines.
-
აირჩიეთ მანქანა თითოეულ ჯობაში. ჯობის
tags-ში მიუთითეთ ზუსტად ერთი Tuist profile label. სხვა ტეგები დაშვებულია, იმ პირობით, რომ დარეგისტრირებულ GitLab რანერსაც აქვს ისინი:# .gitlab-ci.yml linux-check: tags: [tuist-linux] script: - uname -a test: tags: [tuist-macos] script: - tuist test retry: max: 2 when: runner_system_failureyaml# .gitlab-ci.ymllinux-check:tags: [tuist-linux]script:- uname -atest:tags: [tuist-macos]script:- tuist testretry:max: 2when: runner_system_failure -
გაუშვით და დააკვირდით. Tuist იწყებს გამოკითხვას ერთი წუთის განმავლობაში. ჯობები ჩნდება Runners განყოფილებაში, GitLab-ის ჯობაზე, ლოგებსა და მანქანის მეტრიკებზე დამბრუნებელი ბმულით. GitLab იღებს ლოგებს ჯობის შესრულებისას; Tuist იღებს დამალულ ლოგს მისი დასრულებისას.
Tuist კითხულობს CI_JOB_TAGS თითოეული დანიშვნისგან და განსაზღვრავს პროფილს დაკავშირებულ Tuist ანგარიშში. ის არ გამოიტანს მანქანას CI_RUNNER_TAGS-დან და არ იყენებს ნაგულისხმევ პროფილს. დაკარგული, უცნობი ან მრავალი Tuist პროფილის ტეგი აუქმებს მიღებულ ჯობას ახსნით მის GitLab ლოგში. არ გადაწეროთ CI_JOB_TAGS თქვენს პაიპლაინის ცვლადებში.
შესრულების გარემო#
ჯობები იყენებენ GitLab-ის shell executor-ს იზოლირებულ მანქანაში. Checkout, CI ცვლადები, before_script, script, after_script, არტიფაქტები და გაუქმება მუშავდება GitLab Runner-ის მიერ. პაიპლაინის image: და services: პარამეტრები არ აკონფიგურირებენ ამ shell გარემოს; გამოიყენეთ runner image-ზე დაყენებული ინსტრუმენტები ან დააყენეთ ისინი თქვენს სკრიპტში.
გამოყენებადი რანერის ავტორიზაციის ტოკენი რჩება Tuist სერვერზე. მანქანები იღებენ მხოლოდ მათთვის განკუთვნილი ჯობის კრედენციალებს. ქეშის ხელმოწერის უფლებები ამჟამად შეჩერებულია GitLab ჯობებისთვის. მორგებული Linux ქეშის ტომები ამოწმებენ ჯობის იდენტურობას და შენახვის უფლებას GitLab-ის API-ს მეშვეობით; გადაწერადი CI ცვლადები არ ამყარებენ ნდობას.
GitLab ნიშნავს ჯობას როგორც შესრულებადს და იწყებს მის დროის ამოწურვას, როგორც კი Tuist მიიღებს მას. სანამ Tuist-ის მიერ უკვე მიღებული ჯობები იყენებენ თქვენი ანგარიშის კონკურენტულობის ლიმიტს, შემდგომი ჯობები რჩებიან მოლოდინის რეჟიმში GitLab-ში. მიღებული ჯობა ელოდება მანქანას მისი ჯობის დროის ამოწურვამდე, მაქსიმუმ 12 საათი. თუ ამ დროისთვის მანქანა არ გახდება ხელმისაწვდომი, Tuist აუქმებს დანიშვნას runner_system_failure-ით, და ზემოთ მოყვანილი ხელახლა ცდის პოლიტიკა საშუალებას აძლევს GitLab-ს ხელახლა სცადოს ის. იგივე პოლიტიკა ფარავს დაკარგულ რანერ მანქანას.
ტოკენების როტაცია და გათიშვა#
განაახლეთ კავშირის ტოკენები და აირჩიეთ Save changes მათი როტაციისთვის. ტოკენის ველის ცარიელად დატოვება ინარჩუნებს არსებულ კრედენციალს.
Disconnect აჩერებს მიღებას და აუქმებს მოლოდინში მყოფ დანიშვნებს. შესრულებადი ჯობები გრძელდება თავიანთი კრედენციალებით. თუ GitLab-თან წვდომა შეუძლებელია, Tuist ინარჩუნებს გამორთულ კავშირს მოლოდინში მყოფი დანიშვნების გაუქმების ხელახლა ცდისას. კავშირი იშლება მას შემდეგ, რაც ეს დანიშვნები დასრულდება.
ქეშის ტომები#
შეინახეთ Xcode, მოდულის და Gradle ქეშები და სხვა დირექტორიები ჯობებს შორის cache volumes-ის მეშვეობით. დაამატეთ ისინი checkout-ის შემდეგ და იმ ბრძანებებამდე, რომლებიც მათ იყენებენ.
Merge request პაიპლაინები#
პროექტის push, schedule და web პაიპლაინები ინახავენ ცვლილებებს ქეშის ტომებში. Merge request პაიპლაინები იყენებენ ქეშს და ინახავენ ცვლილებებს მხოლოდ მაშინ, როცა კავშირს აქვს API წვდომის ტოკენი:
- GitLab-ში შექმენით პროექტის ან ჯგუფის წვდომის ტოკენი Reporter როლით და
read_apiსკოპით. ჯგუფური ტოკენი ფარავს ჯგუფის ყველა პროექტს, რომელიც მუშაობს Tuist რანერებზე. - Settings → Integrations განყოფილებაში, ჩასვით ის GitLab CI ბარათზე API access token ველში და აირჩიეთ Save changes.
Tuist კითხულობს თითოეული merge request პაიპლაინის merge request-ს. პროექტის საკუთარი ბრენჩიდან გახსნილი merge request-ების პაიპლაინები ინახავენ ცვლილებებს merge request-ის საწყის ბრენჩის ქვეშ, ასე რომ რანერის პროფილის branch settings ვრცელდება ამ ბრენჩზე. Fork-ებიდან მოსული merge request-ები არასდროს ინახავენ. თუ Tuist ვერ კითხულობს merge request-ს, ჯობა მაინც მუშაობს და იყენებს ქეშს, მაგრამ მისი ცვლილებები იკარგება.