CircleCI: βασικά, orbs και συνεχής ενοποίηση

Τι είναι το CircleCI;

CircleCI — είναι μια πλατφόρμα CI/CD στο cloud, που ιδρύθηκε το 2011. Το σύστημα επιτρέπει την περιγραφή των pipeline σε ένα αρχείο YAML .circleci/config.yml και την εκτέλεσή τους σε απομονωμένα containers ή εικονικές μηχανές. Το CircleCI υποστηρίζει όλες τις δημοφιλείς γλώσσες και πλατφόρμες, συμπεριλαμβανομένων των Android, iOS, Flutter και React Native.

Για την ανάπτυξη κινητών, το CircleCI προσφέρει executors macOS για μεταγλώττιση iOS με προεγκατεστημένο Xcode, executors Linux για Android με Android SDK, καθώς και προσωρινή αποθήκευση Gradle και CocoaPods. Βασικό χαρακτηριστικό — orbs, που επιτρέπουν τη σύνδεση έτοιμων διαμορφώσεων με μία γραμμή: orb: android, orb: ios, orb: flutter. Το CircleCI ανιχνεύει αυτόματα τον τύπο του έργου και προτείνει μια πρότυπη διαμόρφωση κατά την πρώτη σύνδεση του αποθετηρίου.

Η πλατφόρμα υποστηρίζει πρόσβαση SSH σε εκτελούμενα containers για αποσφαλμάτωση — χρήσιμη λειτουργία κατά την ανάλυση αποτυχημένων μεταγλωττίσεων. CircleCI CLI επιτρέπει την τοπική επικύρωση και εκτέλεση διαμορφώσεων, τη διαχείριση orbs και την προβολή αρχείων καταγραφής. Η πλατφόρμα ενσωματώνεται με GitHub, GitHub Enterprise, Bitbucket και GitLab μέσω συστήματος webhooks.

Αρχιτεκτονική CircleCI: Orbs, Executors και Contexts

Η αρχιτεκτονική του CircleCI περιλαμβάνει τρία επίπεδα: Pipeline, Workflow και Job. Pipeline — είναι η κύρια διαδικασία, που ενεργοποιείται κατά το commit. Το Pipeline αποτελείται από Workflows — ένα γράφο Jobs που μπορούν να εκτελεστούν σειριακά ή παράλληλα. Κάθε Job εκτελείται σε ένα Executor — ένα περιβάλλον με συγκεκριμένη εικόνα. Το Workflow μπορεί να περιλαμβάνει approval gates — μη αυτόματη επιβεβαίωση πριν από την ανάπτυξη.

Orbs — είναι επαναχρησιμοποιήσιμα πακέτα διαμόρφωσης YAML, που διανέμονται μέσω του CircleCI Orb Registry. Ένα Orb μπορεί να περιέχει jobs, commands, executors και παραδείγματα. Δημοφιλή orbs: android, ios, flutter, firebase, slack. Για παράδειγμα, η σύνδεση του android orb αντικαθιστά 50+ γραμμές διαμόρφωσης με μία γραμμή. Το CircleCI CLI επιτρέπει τη δημιουργία, δοκιμή και δημοσίευση προσαρμοσμένων orbs για την τυποποίηση pipeline στην οργάνωση.

Τύποι Executor

Contexts — είναι ονομασμένα σύνολα μεταβλητών περιβάλλοντος, διαθέσιμα σε επίπεδο οργανισμού. Για παράδειγμα, το context app-store-credentials περιέχει Apple ID και κωδικό πρόσβασης για δημοσίευση στο App Store. Αυτό απλοποιεί τη διαχείριση μυστικών μεταξύ έργων χωρίς αντιγραφή.

Ρύθμιση CircleCI για έργα Android και iOS

Για ένα έργο Android, το CircleCI χρησιμοποιεί την εικόνα Docker cibuilds/android με Android SDK. Τυπικό workflow περιλαμβάνει: checkout, εγκατάσταση JDK, προσωρινή αποθήκευση Gradle, μεταγλώττιση, εκτέλεση δοκιμών. Για iOS απαιτείται executor macOS με Xcode και ρύθμιση code signing. Κατά την πρώτη σύνδεση, το CircleCI ανιχνεύει αυτόματα τον τύπο του έργου και δημιουργεί μια βασική διαμόρφωση με προτεινόμενες ρυθμίσεις.

Για έργα Flutter, το CircleCI παρέχει το orb circleci/flutter, το οποίο περιλαμβάνει executors με προεγκατεστημένο Flutter SDK για Linux και macOS. Το Orb υποστηρίζει μεταγλώττιση και για τις δύο πλατφόρμες, προσωρινή αποθήκευση pub-cache και εκτέλεση δοκιμών. Η ρύθμιση περιορίζεται στον καθορισμό της έκδοσης Flutter και των εντολών μεταγλώττισης. Για προσαρμοσμένες εκδόσεις Flutter ή Dart μπορεί να χρησιμοποιηθεί εικόνα Docker με το απαραίτητο SDK. Το Flutter orb υποστηρίζει επίσης προηγμένες επιλογές — για παράδειγμα, ανάλυση κώδικα μέσω dart analyze πριν από τη μεταγλώττιση.

Android orb — γρήγορη εκκίνηση

Το Android orb από το CircleCI παρέχει έτοιμα jobs: build-and-test, deploy-to-play-store. Το Orb διαμορφώνει αυτόματα το περιβάλλον, την προσωρινή αποθήκευση και την υπογραφή. Μετά τη σύνδεση του orb, αρκεί να καθορίσετε την έκδοση SDK και τις εντολές μεταγλώττισης.

Μεταγλώττιση iOS με executor macOS

Για μεταγλώττιση iOS καθορίζεται executor: macos με έκδοση xcode. Το CircleCI παρέχει εικόνες με Xcode 14, 15 και 16. Μετά το checkout, ο κώδικας μεταγλωττίζεται μέσω xcodebuild, οι δοκιμές εκτελούνται στον προσομοιωτή. Το code signing διαμορφώνεται μέσω fastlane match ή μη αυτόματης εγκατάστασης πιστοποιητικών.

Προσωρινή αποθήκευση και παράλληλη εκτέλεση

Η προσωρινή αποθήκευση — βασικό στοιχείο απόδοσης του CircleCI. Ο μηχανισμός cache διατηρεί καταλόγους μεταξύ εκτελέσεων workflow βάσει κλειδιού. Για το Gradle αποθηκεύεται προσωρινά ~/.gradle, για CocoaPods — Pods/, για npm/SPM — node_modules/.build. Όταν αλλάζει το αρχείο lock, η cache ενημερώνεται αυτόματα. Το CircleCI υποστηρίζει ξεχωριστές πολιτικές: το save_cache μπορεί να καθυστερήσει (when: always), ενώ το restore_cache είναι υποχρεωτικό.

Το Parallelism σε συνδυασμό με το resource class επιτρέπει την ακριβή ρύθμιση της απόδοσης μεταγλώττισης. Resource class καθορίζει την ποσότητα CPU και RAM για το container: small (1 CPU, 2 GB), medium (2 CPU, 4 GB), medium+ (3 CPU, 5 GB) και large (4 CPU, 8 GB). Για μεταγλωττίσεις iOS με Xcode συνιστάται η χρήση macOS executor με resource class medium ή larger — η μεταγλώττιση κώδικα Swift απαιτεί σημαντικούς πόρους.

Το Parallelism χωρίζει τις δοκιμές σε πολλά containers, μειώνοντας τον χρόνο εκτέλεσης. Για παράδειγμα: parallelism: 4 εκτελεί δοκιμές σε 4 παράλληλα containers. Το CircleCI κατανέμει αυτόματα τα αρχεία δοκιμών μεταξύ των containers. Η εντολή circleci tests glob συλλέγει τη λίστα δοκιμών, και το circleci tests split τις κατανέμει ομοιόμορφα.

Παράδειγμα προσωρινής αποθήκευσης Gradle

- restore_cache:
    keys:
      - v1-gradle-{{ checksum "build.gradle" }}
      - v1-gradle-

- run: ./gradlew assembleDebug

- save_cache:
    key: v1-gradle-{{ checksum "build.gradle" }}
    paths:
      - ~/.gradle/caches
      - ~/.gradle/wrapper

Παράδειγμα διαμόρφωσης .circleci/config.yml

Ας εξετάσουμε μια πλήρη διαμόρφωση CircleCI για ένα έργο Android με δύο jobs: build και test. Η διαμόρφωση περιλαμβάνει Docker executor με Android SDK, προσωρινή αποθήκευση Gradle και παράλληλη εκτέλεση δοκιμών. Τα Artifacts αποθηκεύονται για λήψη. Το workflow build-and-test εκτελεί και τα δύο jobs σε κάθε push στον κύριο κλάδο.

version: 2.1

orbs:
  android: circleci/android@2.5.0

jobs:
  build:
    executor: android/default
    steps:
      - checkout
      - android/restore-gradle-cache
      - run: ./gradlew assembleRelease
      - android/save-gradle-cache
      - store_artifacts:
          path: app/build/outputs/apk/release
      - store_test_results:
          path: app/build/reports/tests

  test:
    executor: android/default
    parallelism: 4
    steps:
      - checkout
      - android/restore-gradle-cache
      - run:
          command: |
            cd app
            ./gradlew test

workflows:
  version: 2
  build-and-test:
    jobs:
      - build
      - test

Orbs: έτοιμες λύσεις για CI/CD

Κατά την επιλογή μεταξύ CircleCI και εναλλακτικών — αν η ομάδα χρησιμοποιεί GitHub, το GitHub Actions μπορεί να είναι απλούστερη επιλογή. Το CircleCI είναι προτιμότερο για ομάδες που χρειάζονται ευέλικτο parallel test execution, προσαρμογή περιβάλλοντος executor και λεπτομερή στατιστικά μεταγλώττισης. CircleCI Insights παρέχει έναν πίνακα ελέγχου με μετρήσεις απόδοσης pipeline: μέσος χρόνος μεταγλώττισης, τάσεις και σημεία συμφόρησης. Το Insights βοηθά στον εντοπισμό jobs με μεγάλη διάρκεια εκτέλεσης και στη βελτιστοποίησή τους. Το CircleCI API επιτρέπει τον προγραμματισμένο έλεγχο των pipeline, την εκκίνηση μεταγλωττίσεων και τη λήψη μετρήσεων.

Για ασφαλή εργασία με μυστικά, το CircleCI υποστηρίζει Contexts — ονομασμένα σύνολα μεταβλητών περιβάλλοντος σε επίπεδο οργανισμού. Τα Contexts προστατεύονται με πρόσβαση βάσει ρόλων: μόνο συγκεκριμένες ομάδες μπορούν να χρησιμοποιούν ένα συγκεκριμένο context. Για παράδειγμα, το context production-deploy περιέχει κλειδιά App Store Connect και είναι διαθέσιμο μόνο σε ανώτερους προγραμματιστές. Σε συνδυασμό με τα approval gates, αυτό σχηματίζει ένα πλήρες σύστημα ασφαλείας CI/CD.

Το CircleCI Orb Registry περιέχει εκατοντάδες έτοιμα πακέτα για διάφορες εργασίες CI/CD. Για ανάπτυξη κινητών, τα βασικά orbs περιλαμβάνουν: circleci/android, circleci/ios, circleci/flutter, laurencerussell/firebase-app-distribution. Κάθε orb έχει έκδοση και τεκμηρίωση. Τα Orbs μπορεί να είναι δημόσια (προσβάσιμα σε όλους) και ιδιωτικά (μόνο για τον οργανισμό σας).

Η χρήση orbs μειώνει τη διαμόρφωση 5–10 φορές. Για παράδειγμα, το orb circleci/android παρέχει τον executor android/default με προεγκατεστημένο SDK και τις εντολές restore-gradle-cache, save-gradle-cache. Το orb circleci/ios περιλαμβάνει executor με Xcode και εντολές για code signing μέσω fastlane. Τα Orbs μπορούν εύκολα να συνδυαστούν: συνδέστε το android orb για μεταγλώττιση και το slack orb για ειδοποιήσεις.

Το CircleCI προσφέρει επίσης ενσωματωμένη υποστήριξη για αναφορές δοκιμών. Store_test_results αναλύει και οπτικοποιεί αυτόματα τα αποτελέσματα δοκιμών JUnit, XCTest και άλλων μορφών. Για έργα κινητών, αυτό σημαίνει κεντρική προβολή αποτυχημένων δοκιμών, τάσεων χρόνου εκτέλεσης και ιστορικού σταθερότητας μεταγλώττισης, απλοποιώντας τη διατήρηση της ποιότητας κώδικα.

Παράδειγμα με iOS orb

orbs:
  ios: circleci/ios@2.0.0

jobs:
  build-and-test:
    executor: ios/default
    steps:
      - checkout
      - ios/install-dependencies
      - ios/build-and-test

Δημοσίευση προσαρμοσμένου orb είναι διαθέσιμη μέσω CircleCI CLI. Οι εντολές circleci orb create και circleci orb publish φορτώνουν το orb στο μητρώο. Αυτό είναι χρήσιμο για την τυποποίηση CI/CD εντός του οργανισμού — δημιουργείται μία φορά, χρησιμοποιείται σε όλα τα έργα.