გადადით შინაარსზე

Elixir-პროექტი

plaintext
Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/elixir-project

ერთხელ დააყენეთ Tuist, შემდეგ კი გააგრძელეთ mix compile-ის და mix test-ის გამოყენება. tuist_ex Hex-პაკეტი აკეთებს მხარდაჭერილი დამოკიდებულებების ქეშირებას და აგზავნის ბილდებისა და ტესტების გაშვების შესახებ ინფორმაციას თქვენს დაშბორდზე.

წინაპირობები#

  • Elixir-პროექტი, აგებული Mix-ით, Elixir 1.18 ან უფრო ახალ ვერსიაზე.
  • Tuist-ის ანგარიში.

Tuist-ის დაყენება#

შექმენით პროექტი Tuist-ის დაშბორდზე და აირჩიეთ Mix (Elixir) როგორც ბილდის სისტემა. დაამატეთ პაკეტი დამოკიდებულებებში თქვენს mix.exs-ში:

elixir
defp deps do
[
{:tuist_ex, "~> 0.10", runtime: false}
]
end

ჩამოტვირთეთ ის, დააკონფიგურირეთ თქვენი პროექტი და შედით სისტემაში:

bash
mix deps.get
mix tuist.setup --project account/project
mix tuist.login

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

დააკომიტეთ განახლებული mix.exs, რათა თქვენმა გუნდმა და CI-მ გამოიყენონ ერთი და იგივე კონფიგურაცია. არ არის საჭირო სკრიპტების ან შეფასების კოდის კოპირება. შესვლა ხსნის ბრაუზერს; headless შესვლისა და CI-სთვის საჭირო მონაცემებისთვის იხილეთ ავტორიზაცია.

ახლა გაუშვით თქვენი ჩვეული ბრძანებები:

bash
mix compile
mix test

ბილდები ჩანს Builds-ში, ტესტების გაშვებები — Tests-ში, ხოლო დამოკიდებულებების ქეშის აქტივობა — Mix cache-ში. ეს არის საერთო კონფიგურაცია სამივესთვის. არასტაბილური ტესტების აღმოჩენა იყენებს გაგზავნილ გაშვებებს; ხელახალი ცდები და CI-ში შარდინგი არის არასავალდებულო.

დამოკიდებულებების ქეშირება#

Tuist ავტომატურად ირჩევს მხარდაჭერილ Hex და Git დამოკიდებულებებს, დამოკიდებულებების სიის გარეშე. ქეშში არყოფნის შემთხვევაში კომპილაცია მიმდინარეობს ჩვეულებრივად და შედეგი ინახება; ქეშში ყოფნის შემთხვევაში ის აღდგება. ნატიური/მორგებული კომპილაცია და ლოკალური დამოკიდებულებები რჩება Mix-თან.

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

ბილდის ანალიტიკა#

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

compile ალიასის არსებობისას, Tuist აგზავნის ინფორმაციას ყოველი ბილდის შესახებ: რამდენ ხანს გაგრძელდა, რა გაფრთხილებები და შეცდომები იყო, რამდენ ხანს კომპილირდებოდა თითოეული ფაილი და რა ფაილებზეა ის დამოკიდებული. თქვენი შემდეგი mix compile-ის შემდეგ გახსენით Builds დაშბორდზე, რომ ნახოთ ის.

ტესტების ანალიტიკა#

Tuist იწერს ყოველი ტესტის შედეგს და ხანგრძლივობას ყოველ mix test გაშვებაში, რათა დაინახოთ, როგორ იცვლება თქვენი სატესტო ნაკრები დროთა განმავლობაში, იპოვოთ ნელი ან შენელებული ტესტები და გაიგოთ, რატომ ჩაიშალა გაშვება CI-ში. მათ ნახავთ Tests-ში დაშბორდზე, მოდულის, describe ბლოკის და ტესტის დონეზე.

არასტაბილური ტესტები#

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

elixir
tuist: [project: "account/project", cache: true, test_retries: 2]

ტესტი, რომელიც ხელახალი ცდისას გადის, მონიშნულია როგორც არასტაბილური და გაშვება წარმატებით სრულდება. Flaky Tests გვერდი ჩამოთვლის მათ.

ტესტების შარდინგი#

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

bash
mix tuist.test.build --shard-max 4

შემდეგ თითოეული რანერი ასრულებს თავის წილს TUIST_SHARD_INDEX-ის მითითებით, და შედეგები დაშბორდზე ჩანს როგორც ერთიანი ტესტების გაშვება:

bash
TUIST_SHARD_INDEX=0 mix test

ჩართეთ გუნდი#

ანალიტიკა მრავლდება პროექტთან დაკავშირებული ადამიანების რაოდენობის ზრდასთან ერთად. მიიწვიეთ თქვენი გუნდის წევრები ორგანიზაციაში დაშბორდის ანგარიშის პარამეტრებიდან და დააყენეთ Single Sign-On (Google, Okta, Microsoft), რათა ახალი წევრის დამატება იყოს ერთი დაწკაპუნება და არა თითოეული პირისთვის mix tuist.login-ის შესრულება.

CI-სთვის არ გამოიყენოთ პირადი შესვლა. GitHub Actions, CircleCI და Bitrise შეუძლიათ ავტორიზაცია OpenID Connect-ის მეშვეობით; სხვა პროვაიდერებზე დააყენეთ შეზღუდული TUIST_TOKEN. მიჰყევით CI ავტორიზაციის ნაბიჯებს.