en
Γλώσσα
  • en
  • de
  • fr
  • es
  • br
  • ru
  • jp
  • kr
Μετάφραση AI
  • ae
  • cn
  • vn
  • id
  • eu
  • il
  • gr
  • no
  • fi
  • dk
  • se
  • tr
  • bg
  • nl
  • it
  • pl
  • hu
  • ro
  • ua
  • cs

Ενσωμάτωση GitHub

0 Εισαγωγή

Το GitHub Integration είναι ένα πρόσθετο που μπορεί να προστεθεί σε οποιοδήποτε από τα τρία προγράμματα Easy Redmine.

Ο σκοπός της προσθήκης είναι να συγκεντρώσει σημαντικά δεδομένα από το GitHub στο Easy Redmine για να βοηθήσει στην αναφορά, την αξιολόγηση και την παρουσίαση των δραστηριοτήτων ανάπτυξης, υποστηρίζοντας έτσι τη λήψη αποφάσεων από την πλευρά των ενδιαφερόμενων μερών που επενδύουν στα έργα ανάπτυξης λογισμικού και στις διαδικασίες του η εταιρία.

Οι δυνατότητές του περιλαμβάνουν μια πολύ απλή αρχική σύνδεση με το στιγμιότυπο του GitHub (τόσο αυτο-φιλοξενούμενες είτε εκδόσεις cloud). Όταν δημιουργηθεί η σύνδεση, το Easy Redmine θα εμφανίσει τα πιο σημαντικά στοιχεία από το GitHub σε λίστες με δυνατότητα διαμόρφωσης και φιλτραρίσματος (παρόμοια με μια λίστα εργασιών). Οι οντότητες αυτές είναι:

  • Αποθετήρια
  • Τραβήξτε αιτήματα
  • Δεσμεύεται
  • Δοκιμές

συμπεριλαμβανομένων των σημαντικότερων χαρακτηριστικών τους.

Ένα βασικό στοιχείο της ενσωμάτωσης είναι ότι το Easy Redmine ΔΕΝ αντιγράφει φυσικά τα αποθετήρια. Ο κωδικός παραμένει στο GitHub.

1 Δημιουργία σύνδεσης

Πρώτον, πρέπει να έχετε ένα διακριτικό πρόσβασης από έναν χρήστη στο GitHub, με τα κατάλληλα δικαιώματα.

  1. Επιλέξτε έναν χρήστη μέσω του οποίου το Easy Redmine θα έχει πρόσβαση στο GitHub. Αυτός μπορεί να είναι ένας ειδικός χρήστης από τον οποίο κανένα άτομο δεν συνδέεται, για παράδειγμα, er_integrator
  2. Συνδεθείτε στο GitHub από αυτόν τον χρήστη
  3. Κάντε κλικ στο avatar >> Ρυθμίσεις

  4. Ρυθμίσεις προγραμματιστή

  5. Προσωπικά διακριτικά πρόσβασης

  6. Δημιουργία νέου διακριτικού

  7. Πρέπει να επιτρέψετε αυτά τα πεδία
    - repo (Πλήρης έλεγχος των ιδιωτικών αποθετηρίων)
    - admin:repo_hook (Πλήρης έλεγχος των αγκίστρων αποθετηρίου)
    - χρήστης (Ενημέρωση ΟΛΑ τα δεδομένα χρήστη)
  8. Αντιγράψτε το διακριτικό

    Τώρα, μπορείτε να μεταβείτε στο Easy Redmine και να εισαγάγετε τις ζωτικές πληροφορίες

  9. Μεταβείτε στο Διαχειριστής >> Ενσωμάτωση Git >> Εύρεση Διαθέσιμες ενσωματώσεις και χτύπησε Πρόσθεση

  10. Δώστε στη σύνδεσή σας ένα όνομα, εισαγάγετε τη διεύθυνση URL και το διακριτικό πρόσβασης που δημιουργήσατε νωρίτερα.
    Σημείωση: Σε περίπτωση σύννεφων, π.χ https://github.com/robogithub-easy , απλά μπείτε https://github.com/ χωρίς το δευτερεύον url. Δεν χρειάζεται να ανησυχείτε, μπορείτε να δείτε μόνο έργα που μπορεί να δει ο χρήστης με διακριτικό πρόσβασης. Εάν ορίσετε όλα τα έργα σας ως ιδιωτικά, κανένας άλλος δεν θα μπορεί να τα δει.

  11. Αποθήκευση
  12. Αυτό είναι! Η σύνδεση έχει γίνει.

Όλα τα άλλα γίνονται αυτόματα στο παρασκήνιο. Συγκεκριμένα

  • Το Easy Redmine ανακτά όλα τα έργα/αποθήκες των οποίων είναι μέλος ο χρήστης με διακριτικό πρόσβασης
  • Σε αυτά τα αποθετήρια, δημιουργούνται webhook => έτσι ώστε πληροφορίες σχετικά με νέες δεσμεύσεις, αιτήματα έλξης και δοκιμές θα αποστέλλονται στο Easy Redmine

1.1 Αντιμετώπιση προβλημάτων σύνδεσης

Πρόβλημα Α
Δεν βλέπω κανένα αποθετήριο από αυτήν την παρουσία του GitHub

Λόγω απρόβλεπτων συνθηκών, μπορεί να συμβεί ότι οι προαναφερθείσες λειτουργίες δεν θα πραγματοποιηθούν με επιτυχία. Ως αποτέλεσμα, ενδέχεται να μην βλέπετε κανένα αποθετήριο από αυτήν την παρουσία του GitHub στο Easy Redmine.

Σε αυτήν την περίπτωση, μπορείτε να εισάγετε τα αποθετήρια χειροκίνητα, με λίγα μόνο κλικ.

  1. Μεταβείτε στο Admin >> Git integration >> Configured integrations >> Κάντε κλικ στο όνομα

  2. Στο πλαϊνό μενού, κάντε κλικ Προσθήκη αποθετηρίου

  3. Βρείτε το αποθετήριο

  4. Αφού το επιλέξετε, άλλα πεδία θα συμπληρωθούν αυτόματα
  5. Πατήστε Αποθήκευση
    Προστίθεται αποθετήριο


Πρόβλημα Β
Βρέθηκαν αποθετήρια, αλλά τα νέα μου commit, αιτήματα έλξης και δοκιμές δεν προστίθενται στο Easy Redmine

Νέα δεδομένα από το GitHub αποστέλλονται στο Easy Redmine μέσω webhook που έχουν διαμορφωθεί στο GitHub. Υπό κανονικές συνθήκες, δημιουργούνται αυτόματα. Μπορείτε να το επαληθεύσετε στο έργο σας στο GitHub >> Ρυθμίσεις >> Webhooks


Εάν δεν υπάρχει webhook με τον σύνδεσμο προς την εφαρμογή σας, θα πρέπει να το δημιουργήσετε. Και πάλι, αυτή είναι μια απλή λειτουργία.

  1. Μεταβείτε στο Admin >> Git integration >> Configured integrations >> Κάντε κλικ στο όνομα

  2. Στο πλαϊνό μενού, κάντε κλικ στο Αποθετήρια

  3. Κάντε κλικ στο όνομα ενός

  4. Κάντε κλικ στο Καταχωρίστε όλες τις ενσωματώσεις

Αυτό θα αναγκάσει με μη αυτόματο τρόπο τη δημιουργία του webhook στη σωστή μορφή.

Εάν το webhook υπάρχει, αλλά περιέχει ένδειξη σφάλματος, ελέγξτε το μήνυμα σφάλματος και προσπαθήστε να το επιλύσετε ανάλογα.


2 Αναφορά σε λέξεις-κλειδιά

Τώρα που έχει διαμορφωθεί η γενική σύνδεση, έχετε ήδη πληροφορίες από το GitHub στο Easy Redmine και μπορείτε να τις χρησιμοποιήσετε. Ωστόσο, για να επωφεληθείτε πλήρως από την ενσωμάτωση, υπάρχουν μερικές ακόμη ρυθμίσεις. Ορισμένα είναι ήδη προκαθορισμένα και μπορείτε απλώς να τα ελέγξετε.

Είναι δυνατή η σύνδεση συγκεκριμένων δεσμεύσεων ή έλξης αιτημάτων σε συγκεκριμένες εργασίες, ακόμη και η καταγραφή του χρόνου με αυτόν τον τρόπο χωρίς να χρειάζεται να επισκεφτείτε το Easy Redmine. Αυτό γίνεται με τα λεγόμενα αναφορά σε λέξεις-κλειδιά. Όταν τα χρησιμοποιείτε στο μήνυμα δέσμευσης ή στο όνομα αιτήματος έλξης σε συνδυασμό με το αναγνωριστικό εργασίας, θα δημιουργήσει μια σύνδεση μεταξύ της εργασίας και του στοιχείου GitHub. Τα πιο συνηθισμένα παραδείγματα είναι αναφ. #1234 or κλείνει #1234

Στις περισσότερες περιπτώσεις, θα βρείτε μερικές προκαθορισμένες λέξεις-κλειδιά αναφοράς. Εδώ είναι πώς να εργαστείτε μαζί τους.

  1. Μεταβείτε στο καθολικό μενού >> Ενσωμάτωση Git >> Αναφορές


  2. Δημιουργήστε ή επεξεργαστείτε μια αναφορά
  3. Ολόκληρη η φόρμα περιέχει συμβουλές εργαλείων που θα σας βοηθήσουν να πλοηγηθείτε μέσα από αυτές

Οι πιο σημαντικοί κανόνες που πρέπει να θυμάστε είναι:

  • Η εργασία πρέπει να προσδιορίζεται στη φόρμα #ID , π.χ. #1234
  • Ο χρόνος καταγραφής (αν επιτρέπεται) καταχωρείται πάντα ως @XhYm , π.χ. @1h30m
  • Στις δεσμεύσεις, οι λέξεις-κλειδιά αναφοράς πρέπει να εισαχθούν στο δεσμεύστε το μήνυμα
  • Σε αιτήματα έλξης, οι λέξεις-κλειδιά αναφοράς πρέπει να εισαχθούν στο όνομα του αιτήματος έλξης

3 Χαρτογράφηση χρηστών

Δεδομένου ότι έχουμε να κάνουμε με την ενοποίηση δύο διαφορετικών εφαρμογών, η καθεμία έχει διαφορετικά σύνολα χρηστών. Όλα τα χαρακτηριστικά χρήστη σε οντότητες που σχετίζονται με το GitHub (συγγραφέας δέσμευσης, αναθεωρητής κατόπιν αιτήματος έλξης, κ.λπ.) στο Easy Redmine + χρόνος που καταγράφηκε μέσω λέξεων-κλειδιών αναφοράς, θα πρέπει να συνδέονται με πραγματικούς χρήστες. Λοιπόν, πώς πραγματικά αντιστοιχίζονται οι χρήστες από το GitHub στο Easy Redmine;

Τίποτα επιστημονικό εδώ, οι χρήστες απλώς χαρτογραφούνται μέσω του email και στα δύο προφίλ χρηστών. Βεβαιωθείτε ότι οι προγραμματιστές σας έχουν πανομοιότυπα email τόσο στο GitHub όσο και στο Easy Redmine.

Εάν, για οποιονδήποτε λόγο, ένας χρήστης δεν μπορεί να ενοποιήσει τα email και στις δύο εφαρμογές, υπάρχει η επιλογή να εισαγάγετε επιπλέον email στο Easy Redmine στο προφίλ χρήστη -> εισάγετε το email του Github εδώ.


4 Πώς λειτουργεί

Επιτέλους, φτάνουμε στο διασκεδαστικό κομμάτι. Τι κάνει πραγματικά η ενοποίηση για τους χρήστες. Αποκτήστε πρόσβαση στην κύρια σελίδα/πίνακα ελέγχου της ενοποίησης του Git μέσω του καθολικού μενού (πάνω δεξιά) στην ενότητα Πρόσθετα.


Θα βρείτε μια προσαρμόσιμη σελίδα σε προεπιλεγμένη κατάσταση, την οποία μπορείτε αργότερα να συντονίσετε στις ανάγκες σας.

Περιλαμβάνει επίσης ένα μενού για την καταχώριση οντοτήτων ή την εισαγωγή ρυθμίσεων. Όπως αναφέρθηκε στην εισαγωγή, το Easy Redmine συγκεντρώνει και εμφανίζει 4 κρίσιμες οντότητες από το GitHub. Ας ρίξουμε μια πιο προσεκτική ματιά σε καθένα από αυτά.

4.1 Αποθετήρια

Η λίστα των αποθετηρίων είναι λειτουργικά η λιγότερο ενδιαφέρουσα, αν και πραγματικά απαραίτητη. Ένα χρήσιμο φίλτρο που αξίζει να αναφερθεί ονομάζεται Υπηρεσία, το οποίο θα χρησιμοποιήσετε εάν έχετε συνδεδεμένες διάφορες παρουσίες GitHub και χρειάζεται να κάνετε αναζήτηση μόνο σε ορισμένες από αυτές.


Λεπτομέρεια αποθήκης

:

  • (Κατάργηση-)Καταχώρηση όλων των ενσωματώσεων περιγράφηκαν στο κεφάλαιο 1.1. Θα δημιουργήσει/διαγράψει webhook στο έργο GitHub.
  • Αλλαγή - αλλάξτε χειροκίνητα ορισμένα χαρακτηριστικά. Δεν υπάρχει κανένας άλλος λόγος εκτός από τον προηγμένο εντοπισμό σφαλμάτων για την επεξεργασία οποιωνδήποτε χαρακτηριστικών του αποθετηρίου στο Easy Redmine.
  • Συγχρονίζω - κατεβάζει όλα τα τρέχοντα δεδομένα από το αποθετήριο.
  • Τραβήξτε αιτήματα - παραθέτει όλα τα αιτήματα έλξης σε αυτό το αποθετήριο.
  • Επιλέξτε πρότυπο ακολουθίας - ακόμα σε εξέλιξη, δώστε μας περισσότερο χρόνο για να γυαλίσουμε αυτό το στιβαρό εργαλείο.

4.2 Αιτήματα έλξης (αιτήματα κωδικού)

Θα πρέπει να διευκρινίσουμε γιατί υπάρχουν δύο ονόματα. Αίτημα έλξης είναι ο όρος που χρησιμοποιείται στο GitHub. Άλλα εργαλεία έχουν διαφορετικά ονόματα για αυτό, για παράδειγμα Αίτημα συγχώνευσης. Ο μηχανισμός ενσωμάτωσης του εργαλείου μας είναι γραμμένος με γενικό τρόπο, ώστε να μπορούμε να επεκτείνουμε την υποστήριξη και σε άλλες πλατφόρμες Git. Επομένως, στην εφαρμογή και τις εικόνες μπορεί να βρείτε ετικέτα Αίτημα κωδικού, που είναι ένας γενικός όρος που μπορεί να εφαρμοστεί σε αιτήματα Pull ή Merge.

Το αίτημα έλξης είναι μια πλούσια οντότητα (αποθηκεύει όλα τα σημαντικά χαρακτηριστικά) που επιτρέπει τη δημιουργία ωραίων καταχωρίσεων, αναφορών και ακόμη και γραφημάτων πάνω από αυτά απευθείας στο Easy Redmine.

Λεπτομέρεια του αιτήματος έλξης

:

  • Το όνομα του αιτήματος έλξης περιέχει τη λέξη-κλειδί αναφοράς "refs" ακολουθούμενη από το αναγνωριστικό εργασίας με κατακερματισμό #765 - γι' αυτό συνδέθηκε με την εργασία 765
  • Κάνοντας κλικ στο Συγχρονίζω θα ενημερώσει όλα τα δεδομένα αυτού του PR από το GitHub
  • Όλα τα χαρακτηριστικά μπορούν να εμφανίζονται στη λίστα αιτημάτων έλξης
  • Όλα τα χαρακτηριστικά εκτός από το SHA μπορούν να χρησιμοποιηθούν ως φίλτρα στη λίστα/αναφορά/διάγραμμα αιτημάτων έλξης
  • Η λίστα αιτημάτων έλξης περιέχει επίσης χαρακτηριστικά δοκιμών (CI/CD) που σχετίζονται με αυτήν, το πιο σημαντικό - Κατάσταση δοκιμής

4.3 Δεσμεύει

Παρόμοια με τα αιτήματα έλξης, η λίστα των δεσμεύσεων παρέχει επίσης τεράστιες δυνατότητες αναφοράς. Η λίστα δέσμευσης περιέχει επίσης χαρακτηριστικά από δοκιμές.


Το Commit δεν έχει τη δική του προβολή λεπτομερειών στο Easy Redmine. Απλώς δεν χρειάζεται. Κάνοντας κλικ στο URL (ή SHA), θα κατευθυνθείτε στις λεπτομέρειες του στο GitHub.

Δοκιμές 4.4

Αναφέρθηκαν σε σχέση με τις παραπάνω οντότητες. Οι δοκιμές έχουν επίσης τη δική τους λίστα για τη δημιουργία διαφόρων αναφορών. Πιθανώς η πιο συνηθισμένη χρήση θα είναι η ζωντανή προβολή δοκιμών στα κρίσιμα αποθετήρια, όπως οι υποψήφιοι εκδόσεις.

Η δοκιμή επίσης δεν έχει τη δική της προβολή λεπτομερειών, κάνοντας κλικ θα μεταφερθείτε στο GitHub.

4.5 Συνέργεια - προβολή από εργασία

Ας ρίξουμε μια ματιά στο πώς πάνε όλα μαζί.

1 Συνολική κατάσταση των οντοτήτων GitHub που σχετίζονται με αυτήν την εργασία. Μπορεί να περιέχει διάφορους συνδυασμούς χρωμάτων (κόκκινο, πορτοκαλί, πράσινο) και εικονίδια (σημάδι επιλογής, σταυρός). Το καλύτερο είναι, φυσικά, το πράσινο σημάδι επιλογής στο πράσινο πλαίσιο
Ο συνδυασμός εξαρτάται από την κατάσταση των αιτημάτων έλξης και των αποτελεσμάτων δοκιμής που σχετίζονται με δεσμεύσεις και αιτήματα έλξης. Σκοπός του είναι να δείξει με την πρώτη ματιά πώς πηγαίνει η «τεχνική» πρόοδος αυτής της εργασίας, χρήσιμη ειδικά για τους υπεύθυνους διασφάλισης ποιότητας ή παράδοσης.

2 Όνομα αποθετηρίου(ων) στο οποίο πραγματοποιήθηκαν οι αλλαγές που αναφέρονται σε αυτήν την εργασία. Κάνοντας κλικ στον σύνδεσμο θα κατευθυνθείτε στη λίστα αυτών των δεσμεύσεων.

3 Όνομα αιτημάτων έλξης που αναφέρονται σε αυτήν την εργασία. Κάνοντας κλικ σε αυτό θα κατευθυνθείτε στις λεπτομέρειες του PR στο Easy Redmine.
Σε περίπτωση που υπάρχουν μόνο δεσμεύσεις που αναφέρονται σε αυτήν την εργασία αλλά λείπει το αίτημα έλξης, αυτή η τιμή είναι κενή.

4 Κατάσταση κάθε αιτήματος έλξης. Κάνοντας κλικ σε αυτό θα ανακατευθυνθείτε στη λεπτομέρεια του αιτήματος έλξης στο GitHub.
Σε περίπτωση που υπάρχουν μόνο δεσμεύσεις που αναφέρονται σε αυτήν την εργασία αλλά λείπει το αίτημα έλξης, αυτή η τιμή είναι κενή.

5 Αποτέλεσμα της τελευταίας δοκιμαστικής εκτέλεσης στο αίτημα έλξης. Κάνοντας κλικ σε αυτό θα κατευθυνθείτε στο GitHub. Δεν υπάρχει δυνατότητα κλικ Άγνωστος κατάσταση (η δοκιμή δεν υπάρχει).
Σε περίπτωση που υπάρχουν μόνο δεσμεύσεις που αναφέρονται σε αυτήν την εργασία αλλά λείπει το αίτημα έλξης, η τιμή δείχνει το τελευταίο αποτέλεσμα δοκιμής που εκτελέστηκε στην τελευταία δέσμευση.

6 Εκτελέστε τη δοκιμή χειροκίνητα - σας μεταφέρει στο GitHub.

7 Κάντε κλικ για να δημιουργήσετε ένα αίτημα έλξης. Χρήσιμο όταν έχετε μόνο ένα σύνολο δεσμεύσεων, αλλά σας λείπει το PR (σας μεταφέρει στο GitHub).

4.6 Δημιουργία διακλάδωσης από εργασία

Μερικοί χρήστες βρίσκουν χρήσιμο να δημιουργήσουν έναν κλάδο απευθείας από την εργασία.

Το κουμπί βρίσκεται στο παγκόσμιο μενού στη λεπτομέρεια της εργασίας


Επιλέξτε το αποθετήριο στο πεδίο αυτόματης συμπλήρωσης. Το όνομα του κλάδου είναι προσυμπληρωμένο με αναγνωριστικό εργασίας και θέμα, αλλά μπορείτε να το αλλάξετε. Ο κλάδος προέλευσης συμπληρώνεται από κύριος

Θα δείτε τον κλάδο ως ετικέτα στην ενότητα Ενσωμάτωση Git στην εργασία. Έχει δυνατότητα κλικ και οδηγεί στον κλάδο στο GitHub.



5 Άδειες

Αυτήν τη στιγμή υπάρχουν δύο άδειες.

  • Προβολή - Πρόσβαση στο πρόσθετο από το καθολικό μενού
  • Διαχείριση - επεξεργασία του πίνακα ελέγχου

Η καθολική διαμόρφωση είναι προσβάσιμη μόνο στον διαχειριστή του Easy Redmine.

Δοκιμάστε το Easy Redmine σε δωρεάν δοκιμή 30 ημερών

Πλήρεις δυνατότητες, προστασία SSL, καθημερινά αντίγραφα ασφαλείας, στη γεωγραφική σας τοποθεσία