Ρύθμιση παραμέτρων διοχετεύσεων ALM Accelerator
Οι διοχέτευσης είναι οι μηχανές του ALM Accelerator. Αυτοματοποιούν τη διεργασία ALM για το Power Platform. Είναι ενσωματωμένες με χρήση των διοχέτευσης Azure, μιας υπηρεσία του Azure DevOps και αποθηκεύονται σε ένα έργο Azure DevOps.
Τέσσερις κύριες διοχέτευσης χρησιμοποιούνται για την αυτοματοποίηση της διεργασίας ALM:
- Import
- Export
- Delete
- Δημιουργία/Ανάπτυξη
Οι διοχέτευσης είναι σχεδιασμένες για χρήση με την εφαρμογή καμβά ALM Accelerator. Δεν χρειάζεται να χρησιμοποιήσετε την εφαρμογή, αλλά το συνιστούμε. Η εφαρμογή παρέχει ένα απλό περιβάλλον εργασίας χρήστη για να καλείτε τις διοχέτευσης και έναν τρόπο για να τις ρυθμίσετε χωρίς να χρειάζεται να κατανοήσετε τις υφιστάμενες παραμέτρους.
Κοινά σενάρια διοχέτευσης ALM Accelerator
Οι διοχετεύσεις ALM Accelerator και η εφαρμογή έχουν προεπιλεγμένες ρυθμίσεις παραμέτρων που σας επιτρέπουν να ξεκινήσετε γρήγορα με το ALM για Power Platform. Οι διοχέτευσης μπορούν να καλύψουν πολλά διαφορετικά σενάρια ALM προκειμένου να ανταποκριθούν στις απαιτήσεις του οργανισμού σας. Οι ακόλουθες ενότητες περιγράφουν ορισμένα κοινά σενάρια και πώς μπορούν να καλύπτονται μέσω ρύθμισης παραμέτρων διοχέτευσης, προφίλ ανάπτυξης και βημάτων στην εφαρμογή ALM Accelerator ή απευθείας μέσω της διοχέτευσης.
Εγκατάσταση των διοχέτευσης σε ένα έργο και του κώδικα προέλευσης σε άλλο έργο
Στην εφαρμογή ALM Accelerator και στα προφίλ ανάπτυξης, μπορείτε να καθορίσετε ένα έργο διοχέτευσης και ένα έργο προέλευσης. Μια επιλογή στον οδηγό εγκατάστασης σάς επιτρέπει να καθορίσετε ένα ξεχωριστό έργο διοχέτευσης και ένα αρχείο αποθετηρίου. Αυτές οι επιλογές είναι χρήσιμες εάν θέλετε να κατανείμετε τον χώρο αποθήκευσης λύσεων βάσει των χρηστών, της εταιρικής δομής ή άλλων παραγόντων. Στις περισσότερες περιπτώσεις, τα αρχεία διοχέτευσης YAML αποθηκεύονται στο έργο διοχέτευσης και οι εξαγωγές, η εισαγωγή και η διαγραφή των διοχέτευσης δημιουργούνται στο έργο όπου η λύση ελέγχεται από προέλευση.
Εκτέλεση των διοχέτευσης χωρίς τον ALM Accelerator
Η εφαρμογή καμβά ALM Accelerator παρέχει ένα εύκολο επίπεδο κουμπιών για την εκτέλεση των διοχέτευσης. Ωστόσο, δεν χρειάζεστε την εφαρμογή για να τις εκτελέσετε. Αν θέλετε να χρησιμοποιήσετε τις διοχέτευσης που είναι ανεξάρτητες από την εφαρμογή, εκτελέστε τις απευθείας από τη γραμμή εντολών. Μπορείτε, επίσης, να δημιουργήσετε τη δική σας εφαρμογή. Χρησιμοποιήστε μια προσαρμοσμένη σύνδεση για το API Azure DevOps, που περιλαμβάνεται στη λύση ALM Accelerator, για να καλείτε τις διοχέτευσης χρησιμοποιώντας Power Automate ή άλλες τεχνολογίες Power Platform.
Σε κάθε περίπτωση, εάν θέλετε να χρησιμοποιήσετε τις διοχέτευσης ανεξάρτητα, το κλειδί είναι να κατανοήσετε τις παραμέτρους που περνούν σε αυτές.
Παράμετροι διοχέτευσης
Παράμετροι για περιβάλλον εισαγωγής-μη διαχειριζόμενο σε ανάπτυξη: Χρησιμοποιήστε τη διοχέτευση λύσης εισαγωγής για να εισαγάγετε μια μη διαχειριζόμενη λύση από το στοιχείο ελέγχου προέλευσης σε ένα περιβάλλον ανάπτυξης.
Ο ακόλουθος πίνακας περιγράφει τις παραμέτρους της διοχέτευσης εισαγωγής.
| Παράμετρος | Παράδειγμα | Περιγραφή |
|---|---|---|
| Project | Το έργο μου Azure DevOps | Το όνομα του έργου στο οποίο θα εισαχθεί η λύση |
| Αποθετήριο | Το αποθετήριο Azure DevOps μου | Το όνομα του αποθετηρίου από το οποίο θα εισαχθεί η λύση |
| Όνομα λύσης | MySolutionName | Το όνομα της λύσης προς για εισαγωγή |
| Διεύθυνση ηλεκτρονικού ταχυδρομείου | me@example.com | Η διεύθυνση ηλεκτρονικού ταχυδρομείου του χρήστη που εισάγει τη λύση |
| UserName | Τελευταία, Πρώτη | Το όνομα χρήστη του χρήστη που εισάγει τη λύση |
| Διακλάδωση | main | Ο κλάδος για τη δημιουργία της λύσης και την εισαγωγή από το |
| ServiceConnectionName | MyServiceConnection | Το όνομα της σύνδεσης εξυπηρέτησης που θα χρησιμοποιηθεί για την εισαγωγή |
| ServiceConnectionUrl | example.crm.dynamics.com | Η διεύθυνση URL του περιβάλλοντος δημιουργού για την εισαγωγή |
| EnvironmentName | MyDevEnvironment | Χρησιμοποιείται για την εύρεση των ρυθμίσεων ανάπτυξης στην διοχέτευση της ανάπτυξης. επιστρέφει ένα όνομα φακέλου κάτω από τον κατάλογο ρύθμισης παραμέτρων στην προέλευση λύσης |
Παράμετροι για διαγραφή-μη διαχειριζόμενη-λύση-και-στοιχεία: Χρησιμοποιήστε τη διοχέτευση λύσης διαγραφής για να διαγράψετε μια μη διαχειριζόμενη λύση και όλα τα στοιχεία της από ένα περιβάλλον ανάπτυξης.
Ο ακόλουθος πίνακας περιγράφει τις παραμέτρους της διοχέτευσης διαγραφής.
| Παράμετρος | Παράδειγμα | Περιγραφή |
|---|---|---|
| Όνομα λύσης | MySolutionName | Το όνομα της λύσης για διαγραφή |
| ServiceConnectionName | MyServiceConnection | Το όνομα της σύνδεσης εξυπηρέτησης που θα χρησιμοποιηθεί για τη λύση προς διαγραφή |
| ServiceConnectionUrl | example.crm.dynamics.com | Η διεύθυνση URL του περιβάλλοντος δημιουργού για τη διαγραφή της λύσης |
Παράμετροι για export-solution-to-git: Χρησιμοποιήστε τη διοχέτευση λύσης εξαγωγής για να εξαγάγετε τη λύση σε ένα αποθετήριο Git.
Ο ακόλουθος πίνακας περιγράφει τις παραμέτρους της διοχέτευσης εξαγωγής.
| Παράμετρος | Παράδειγμα | Περιγραφή |
|---|---|---|
| Project | Το έργο μου Azure DevOps | Το όνομα του έργου στο οποίο θα εισαχθεί ο πηγαίος κώδικας της λύσης |
| Αποθετήριο | Το αποθετήριο Azure DevOps μου | Το όνομα του αποθετηρίου στο οποίο θα εισαχθεί ο πηγαίος κώδικας της λύσης |
| Όνομα λύσης | MySolutionName | Το όνομα της λύσης προς εξαγωγή |
| Διεύθυνση ηλεκτρονικού ταχυδρομείου | me@example.com | Η διεύθυνση ηλεκτρονικού ταχυδρομείου του χρήστη που εξάγει τη λύση |
| UserName | Τελευταία, Πρώτη | Το όνομα χρήστη του χρήστη που εξάγει τη λύση |
| CommitMessage | Επιδιορθώσεις σφάλματος #1234 | Μια περιγραφή των αλλαγών που πρέπει να δεσμευτούν στο αποθετήριο |
| Διακλάδωση | main | Είτε η διακλάδωση προέλευσης για τη δημιουργία μιας διακλάδωσης από ή η υπάρχουσα διακλάδωση σε |
| BranchToCreate | δυνατότητα-1234 | Το μοναδικό όνομα μιας νέας διακλάδωσης που θα δημιουργηθεί με βάση την Branch παράμετρο, εάν είναι απαραίτητο |
| ServiceConnectionName | MyServiceConnection | Το όνομα της σύνδεσης εξυπηρέτησης που θα χρησιμοποιηθεί για την εξαγωγή λύσης |
| ServiceConnectionUrl | example.crm.dynamics.com | Η διεύθυνση URL του περιβάλλοντος δημιουργού όπου υπάρχει η μη διαχειριζόμενη λύση προς εξαγωγή |
| Δεδομένα | [Ρυθμίσεις ανάπτυξης JSON] | Μια συμβολοσειρά JSON που περιέχει τις ρυθμίσεις ανάπτυξης που θα χρησιμοποιηθεί για εξαγωγή και ρύθμιση παραμέτρων διοχέτευσης ανάπτυξης |
| PortalSiteName | MyPortalSite | Το όνομα της τοποθεσίας Web Power Pages που σχετίζεται με τη λύση προς εξαγωγή |
Προσαρμογή της έκδοσης των λύσεων όταν χρησιμοποιείτε τις διοχέτευσης ALM Accelerator για την εξαγωγή ή την ανάπτυξη τους
Από προεπιλογή, η έκδοση των λύσεων που έχουν εξαχθεί και αναπτυχθεί χρησιμοποιείται με χρήση του ονόματος που καθορίζεται στο αρχείο YAML της διοχέτευσης ανάπτυξης. Ωστόσο, οι διοχετεύσεις ALM Accelerator σας επιτρέπουν να προσαρμόσετε την έκδοση μιας λύσης κατά την εξαγωγή ή την ανάπτυξή της. Οι ακόλουθες ενότητες περιγράφουν τις μεθόδους που μπορείτε να χρησιμοποιήσετε.
Εξαγόμενη έκδοση
Χρησιμοποιήστε τον αριθμό έκδοσης που έχει εξαχθεί από τις διοχέτευσης ως αριθμό έκδοσης σε όλα τα περιβάλλοντα που έχουν αναπτυχθεί. Δημιουργήστε μια μεταβλητή με το όνομα UseSolutionVersionFromDataverse στη διοχέτευση εξαγωγής ή μια παγκόσμια μεταβλητή στη βιβλιοθήκη μεταβλητών για τον ALM Accelerator. Δώστε της μια τιμή True. Η μεταβλητή διασφαλίζει ότι ο αριθμός έκδοσης που εξάγεται στη λύση σας διατηρείται σε κατάντη περιβάλλοντα και αντικατοπτρίζεται στον έλεγχο πηγής σας όταν η πηγή της λύσης δεσμεύεται.
Προσαρμοσμένη λογική εκδόσεων
Χρησιμοποιήστε τον ALM Accelerator για να ορίσετε την έκδοση της λύσης. Προσθέστε την προσαρμοσμένη λογική σας στο πρότυπο build-solution-pack-pre-hook.yml για να διαχειριστείτε απευθείας Solution.xml ή χρησιμοποιώντας άλλα εργαλεία, όπως την έκδοση λύσης pac.
Προσαρμοσμένη έκδοση "φέρτε τα δικά σας πρότυπα"
Η δυνατότητα να φέρετε τα δικά σας πρότυπα για τη δημιουργία διοχέτευσης ανάπτυξης παρέχει ευελιξία για τη δημιουργία εκδόσεων κατά την αρχική εξαγωγή μιας λύσης. Για παράδειγμα, δημιουργήστε ένα αντίγραφο ενός build-deploy-validation/test/prod-SampleSolution.yml και αλλάξτε το όνομα δόμησης από το προεπιλεγμένο σε μια στρατηγική δημιουργίας εκδόσεων βάσει των παραμέτρων εκτέλεσης ή δημιουργίας αριθμών:
build:
- name: 1.0.$(Date:yyyyMMdd)$(Rev:.r)
...
Αφού τοποθετήσετε τα πρότυπά σας, ενημερώστε τα βήματα ανάπτυξης στο προφίλ ανάπτυξής σας για να τα τοποθετήσετε σε αυτό.
Προσαρμόστε τον αριθμό των βημάτων ανάπτυξης στις διοχετεύσεις σας και τα ονόματα του περιβάλλοντος προορισμού
Παρόμοια με την προσαρμοσμένη έκδοση με πρότυπα, η δυνατότητα να φέρετε τα δικά σας πρότυπα για τη δημιουργία διοχετεύσεων ανάπτυξης παρέχει μεγαλύτερη ευελιξία κατά την αρχική εξαγωγή μιας λύσης. Καθορίστε το έργο στο οποίο υπάρχουν τα πρότυπά σας και τη διαδρομή προς το πρότυπο που θα χρησιμοποιηθεί για τη δημιουργία της διοχέτευσης ανάπτυξης. Οι ρυθμίσεις για το έργο και τη διαδρομή βρίσκονται στο προφίλ ανάπτυξης και στον πίνακα "Βήματα ανάπτυξης" στην εφαρμογή διαχείρισης ALM Accelerator.
Η διαδρομή προς το πρότυπο είναι σχετική με τη ρίζα της θέσης της διοχέτευσης εξαγωγής. Για παράδειγμα, η διαδρομή προς το προεπιλεγμένο περιβάλλον επικύρωσης είναι τα πρότυπα διοχέτευσης ανάπτυξης στο /Pipelines/build-deploy-validation-SampleSolution.yml. Για να χρησιμοποιήσετε ένα πρότυπο στο ίδιο έργο με τη διοχέτευση εξαγωγής, καθορίστε τη διαδρομή όπως /Pipelines/build-deploy-validation-MyCustomTemplate.yml.
Ο παρακάτω πίνακας περιγράφει τους σύμβολα κράτησης θέσης στα πρότυπα για τιμές που αφορούν συγκεκριμένη λύση, οι οποία αντικαθίστανται όταν δημιουργείται η διοχέτευση ανάπτυξης.
| Σύμβολο κράτησης θέσης | Περιγραφή |
|---|---|
| SampleSolutionName | Το όνομα της λύσης προς ανάπτυξη |
| RepositoryContainingTheBuildTemplates | Το αποθετήριο που περιέχει τα πρότυπα δόμησης που θα χρησιμοποιηθούν για τη διοχέτευση ανάπτυξης |
| BranchContainingTheBuildTemplates | Η διακλάδωση που περιέχει τα πρότυπα δόμησης που θα χρησιμοποιηθούν για τη διοχέτευση ανάπτυξης |
| alm-accelerator-variable-group | Η ομάδα καθολικών μεταβλητών που χρησιμοποιούν τα πρότυπα δόμησης για τη διοχέτευση ανάπτυξης |
Συνιστούμε να αντιγράψετε ένα πρότυπο διοχέτευσης build-deploy-validation/test/prod-SampleSolution.yml για να ξεκινήσετε με το δικό σας προσαρμοσμένο πρότυπο.
Εκτελέστε προσαρμοσμένα βήματα στις διοχέτευσης χωρίς να τροποποιήσετε τα προεπιλεγμένα πρότυπα
Τα πρότυπα διοχέτευσης ALM Accelerator έχουν διάφορα σημεία επέκτασης ή σημεία διοχέτευσης, τα οποία μπορείτε να χρησιμοποιήσετε για να προσαρμόσετε τις διοχέτευσης ελαχιστοποιώντας το θόρυβο από διενέξεις συγχώνευσης σε σενάρια αναβάθμισης. Μάθετε περισσότερα σχετικά με τα άγκιστρα επιτάχυνσης ALM.
Ενεργοποίηση ή απενεργοποίηση συγκεκριμένων ενεργειών σε διοχέτευση
Οι διοχέτευσης χρησιμοποιούν μεταβλητές για να καθορίσουν εάν μια εργασία πρέπει να εκτελεστεί ή όχι ή ποια εργασία διαφόρων δυνατοτήτων πρέπει να εκτελεστεί. Ο παρακάτω πίνακας περιγράφει τις μεταβλητές που μπορείτε να ορίσετε για μια μεμονωμένη διοχέτευση ή, μέσω της ομάδας alm-accelerator-variable-group, όλες τις διοχέτευσης.
Σημείωμα
Για να ορίσετε αυτές τις μεταβλητές για συγκεκριμένες λύσεις κατά την εξαγωγή, δημιουργήστε μια συγκεκριμένη διοχέτευση εξαγωγής με βάση το πρότυπο διοχέτευσης εξαγωγής. Ονομάστε το export-solution-to-git-{SolutionName}. Η εφαρμογή ALM Accelerator χρησιμοποιεί αυτήν τη διοχέτευση εξαγωγής για τη λύση και όχι τη διοχέτευση γενικής χρήσης εξαγωγής λύσης προς git.
| Μεταβλητή | Προεπιλεγμένος | Διοχετεύσεις | Περιγραφή |
|---|---|---|---|
| GenerateDeploymentSettings | Ενεργή | Export | Εάν είναι false, οι ρυθμίσεις ανάπτυξης δεν δημιουργούνται και αποθηκεύονται στο στοιχείο ελέγχου προέλευσης. |
| UseDeploymentSettingsPlaceholders | Ενεργή | Export | Εάν είναι false, οι ρυθμίσεις ανάπτυξης δεν χρησιμοποιούν χαρακτήρες κράτησης θέσης και όλες οι τιμές για τις ρυθμίσεις ανάπτυξης αποθηκεύονται στα αρχεία deploymentSettings.json και customDeploymentSettings.json .ΣΗΜΑΝΤΙΚΟ: Οι ευαίσθητες πληροφορίες ενδέχεται να αποθηκευτούν σε απλό κείμενο στις ρυθμίσεις ανάπτυξης. Όλοι οι χρήστες που έχουν πρόσβαση στο στοιχείο ελέγχου προέλευσης μπορούν να διαβάσουν αυτές τις τιμές. Φροντίστε να ορίσετε μια τιμή για αυτήν τη μεταβλητή. |
| DisableFlows | Ανενεργή | Export | Αν είναι true, όλες οι ροές απενεργοποιούνται στον αποσυμπιεσμένο κώδικα προέλευσης πριν από τη δέσμευση. |
| UseSolutionVersionFromDataverse | Ανενεργή | Export | Εάν είναι true, ο αριθμός έκδοσης που έχει εξαχθεί στη λύση σας διατηρείται σε κατάντη περιβάλλοντα. Ο αριθμός έκδοσης αντικατοπτρίζεται στο στοιχείο ελέγχου προέλευσης όταν η προέλευση λύσης έχει δεσμευθεί. |
| DoNotExportCurrentEnvironmentVariableValues | Ανενεργή | Export | Εάν είναι true, οι τιμές των μεταβλητών για το τρέχον περιβάλλον καταργούνται από τον κωδικό προέλευσης για τη μη αποσυμπιεσμένη λύση. |
| PublishCustomizationsBeforeExport | Ενεργή | Export | Εάν είναι false, οι προσαρμογές δεν δημοσιεύονται πριν την εξαγωγή της λύσης. Αυτή η επιλογή είναι χρήσιμη εάν εργάζεστε σε ένα κοινόχρηστο περιβάλλον και θέλετε μόνο να εξαγάγετε τις πιο πρόσφατες δημοσιευμένες προσαρμογές. |
| CacheEnabled | Ενεργή | Εξαγωγή / Ανάπτυξη | Εάν είναι false, η προσωρινή αποθήκευση των μονάδων PowerShell απενεργοποιείται. Αυτή η επιλογή είναι χρήσιμη εάν οι διοχέτευσης σας εκτελούν εκκαθάριση του καταλόγου προσωρινής μνήμης μετά την εκτέλεση των διοχέτευσης. |
| ProcessCanvasApps | Ενεργή | Εξαγωγή / Ανάπτυξη | Αν False, οι εφαρμογές καμβά δεν αποσυμπιέζονται κατά την εξαγωγή ή δεν συσκευάζονται κατά τη διάρκεια της δημιουργίας. ΣΗΜΕΙΩΣΗ: Η λειτουργία αποσυσκευασίας και συσκευασίας καμβά βρίσκεται αυτήν τη στιγμή σε έκδοση προεπισκόπησης. Δεν συνιστάται για χρήση σε περιβάλλοντα περιβαλλόντων αυτήν την εποχή. Ωστόσο, δεν μπορείτε να προβάλετε τον κώδικα προέλευσης καμβά στο στοιχείο ελέγχου προέλευσης, εκτός εάν ορίσετε αυτήν τη μεταβλητή σε True. |
| DisableSolutionChecker | Ανενεργή | Ανάπτυξη | Εάν είναι true, ο έλεγχος λύσης δεν εκτελείται σε κάθε έκδοση που ξεκινάει μέσω ενός αιτήματος έλξης. |
| SkipSolutionImport | Ανενεργή | Ανάπτυξη | Εάν είναι true, το βήμα εισαγωγής λύσης παραλείπεται κατά την ανάπτυξη. Ωστόσο, άλλες δραστηριότητες, όπως οι ενεργοποιήσεις ροής και η κοινή χρήση, θα εξακολουθούν να εκτελούνται. |