Ανάπτυξη παράγοντα στο Azure

Έχετε δημιουργήσει τον παράγοντας σας και τον έχετε δοκιμάσει τοπικά. Τώρα, ζωντανέψτε το στο cloud. Αυτό το βήμα είναι προαιρετικό. Μπορείτε να το παραλείψετε εάν έχετε ήδη αναπτύξει τον παράγοντα σας σε κάποιο cloud (δεν χρειάζεται καν να είναι το Azure).

Αυτός ο οδηγός σας καθοδηγεί στη διαδικασία ανάπτυξης του κώδικα του παράγοντα σας στο Azure και δημοσίευσής του στο κέντρο διαχείρισης της Microsoft, όπου γίνεται καταχωρημένο στοιχείο για τον οργανισμό σας.

Για να ενημερώσετε το τελικό σημείο ανταλλαγής μηνυμάτων, ανατρέξτε στους παρακάτω πόρους. Δείχνουν πώς μπορείτε να ενημερώσετε το messaging endpoint αν έχετε αναπτύξει τον παράγοντα σας σε άλλους παρόχους cloud, όπως τις Υπηρεσίες Web της Amazon ή την Πλατφόρμα Google Cloud:

Προαπαιτούμενα στοιχεία

Προτού ξεκινήσετε, εξασφαλίστε ότι έχετε τα παρακάτω στοιχεία:

Απαιτούμενοι λογαριασμοί και δικαιώματα

Συνδρομή Azure με δικαιώματα συνεισφέροντα.
Λειτουργικός κώδικας παράγοντα με έγκυρο και προσβάσιμο σημείο τερματισμού ανταλλαγής μηνυμάτων. Βεβαιωθείτε ότι έχετε δοκιμάσει τον παράγοντα σας τοπικά και, προαιρετικά, ότι έχετε δοκιμάσει με το Microsoft 365 χρησιμοποιώντας Dev Tunnels, ώστε να επαληθεύσετε ότι ο κώδικας του παράγοντα μπορεί να γίνει build και να εκτελεστεί όπως αναμένεται:
Έγκυρο πλάνο παράγοντα με την ολοκλήρωση του βήματος δημιουργίας πλάνου παράγοντα.
Ενημερωμένα αρχεία διαμόρφωσης a365.config.json, a365.generated.config.json και αρχείο διαμόρφωσης στον κώδικα (για παράδειγμα, αρχείο .env).

Απαιτούμενα εργαλεία

Εγκατεστημένο και εξουσιοδοτημένο Azure CLI (Εγκατάσταση Azure CLI)

Ανάπτυξη στο Azure

Αναπτύξτε τον κώδικα της εφαρμογής παράγοντά σας στο Azure χρησιμοποιώντας τυπικά εργαλεία Azure, όπως το Azure CLI, την πύλη Azure ή τις ενέργειες GitHub.

Ανάπτυξη εφαρμογής παράγοντα

Χρησιμοποιήστε την Azure CLI az webapp deployεντολή για να αναπτύξετε την εφαρμογή σας:

# Build your project first (example for .NET)
dotnet publish -c Release -o ./publish

# Deploy to Azure Web App
az webapp deploy --name <your-web-app> --resource-group <your-resource-group> --src-path ./publish

Για GitHub Actions, χρησιμοποιήστε την Azure Web Apps Deploy action.

Προειδοποίηση

Διαχείριση μυστικών: Αποθηκεύστε μεταβλητές περιβάλλοντος, συμπεριλαμβανομένων των κλειδιών API και των μυστικών, ως Ρυθμίσεις εφαρμογής Azure και όχι σε αρχεία κώδικα ή ρύθμισης παραμέτρων. Για περιβάλλοντα παραγωγής, χρησιμοποιήστε το Azure Key Vault για ευαίσθητα μυστικά. Μάθετε περισσότερα σχετικά με την ασφαλή αποθήκευση μυστικών εφαρμογής κατά την ανάπτυξη στο ASP.NET Core και τον πάροχο ρύθμισης παραμέτρων Azure Key Vault. Ποτέ μην δεσμεύετε αρχεία .env με ευαίσθητες πληροφορίες στον έλεγχο προέλευσης.

Έλεγχος ανάπτυξης

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

✅ Η εντολή ανάπτυξης ολοκληρώθηκε χωρίς σφάλματα
✅ Η εφαρμογή web εκτελείται
✅ Τα αρχεία καταγραφής εφαρμογών δείχνουν επιτυχή εκκίνηση
✅ Οι μεταβλητές περιβάλλοντος είναι ρυθμισμένες
✅ Το τελικό σημείο ανταλλαγής μηνυμάτων αποκρίνεται

Επαληθεύστε ότι η εντολή ανάπτυξης ολοκληρώθηκε χωρίς σφάλματα

Αφού ολοκληρωθεί η ανάπτυξη, επαληθεύστε την επιτυχία στα αρχεία καταγραφής ανάπτυξης:

Μεταβείτε στην εφαρμογή web στην πύλη Azure.
Μεταβείτε στις Ρυθμίσεις> και Ρύθμιση για να επαληθεύσετε τις ρυθμίσεις της εφαρμογής.
Ελέγξτε τις καταγραφές ανάπτυξης στο Κέντρο Ανάπτυξης

Για να δείτε λεπτομερές ιστορικό ανάπτυξης:

Μετάβαση στην πύλη Azure > Η εφαρμογή web σας
Ανάπτυξη>Κέντρο ανάπτυξης
Δείτε τα αρχεία καταγραφής της τελευταίας ανάπτυξης

Εάν η δημιουργία αποτύχει:

Καθαρίστε και ανακατασκευάστε πρώτα τοπικά για να επιβεβαιώσετε ότι η δημιουργία είναι επιτυχής.
Ελέγξτε για εξαρτήσεις που λείπουν ή συντακτικά σφάλματα.
Δείτε Η εντολή ανάπτυξης αποτυγχάνει.

Εάν η εφαρμογή διακοπεί μετά την ανάπτυξη:

Ελέγξτε τα αρχεία καταγραφής για συγκεκριμένα μηνύματα σφάλματος.
Βεβαιωθείτε ότι έχουν οριστεί όλες οι απαιτούμενες μεταβλητές περιβάλλοντος.
Δείτε Η εφαρμογή διακόπτεται στην εκκίνηση.

Επαληθεύστε ότι η εφαρμογή Ιστού εκτελείται

Χρησιμοποιήστε την εντολή az webapp show για να επαληθεύσετε ότι η εφαρμογή Ιστού εκτελείται.

az webapp show --name <your-web-app> --resource-group <your-resource-group> --query state

Η αναμενόμενη έξοδος αυτής της εντολής είναι Running.

Επαληθεύστε ότι τα αρχεία καταγραφής εφαρμογών δείχνουν επιτυχή εκκίνηση

Για να προβάλετε αρχεία καταγραφής εφαρμογών web στην πύλη Azure:

Αναζητήστε την εφαρμογή web με το όνομά της στην πύλη Azure.
Μεταβείτε στην Επισκόπηση>Αρχεία καταγραφής>Ροή καταγραφής.

Εναλλακτικά, μπορείτε να χρησιμοποιήσετε την az webapp log tailεντολή PowerShell για να διαβάσετε αρχεία καταγραφής εφαρμογών ιστού:

az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

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

Επαληθεύστε ότι οι μεταβλητές περιβάλλοντος είναι ρυθμισμένες

Στην πύλη Azure:

Μεταβείτε στην εφαρμογή ιστού σας.
Μεταβείτε στις Ρυθμίσεις>Μεταβλητές περιβάλλοντος.
Βεβαιωθείτε ότι οι ρυθμίσεις σας υπάρχουν.

Εάν οι μεταβλητές περιβάλλοντος δεν έχουν οριστεί:

Επανεκτελέστε την ανάπτυξη για συγχρονισμό από το αρχείο .env.
Ή ορίστε τις μεταβλητές χειροκίνητα στην πύλη Azure.
Ανατρέξτε στο Οι μεταβλητές περιβάλλοντος δεν έχουν οριστεί ή είναι λανθασμένες.

Βεβαιωθείτε ότι το τελικό σημείο ανταλλαγής μηνυμάτων ανταποκρίνεται

Ελέγξτε ότι το τελικό σημείο που βρίσκετε στη σελίδα Επισκόπηση της εφαρμογής web υπάρχει χρησιμοποιώντας το PowerShell ή άλλα μέσα. Εναλλακτικά, δείτε 404 σφάλμα στο τελικό σημείο ανταλλαγής μηνυμάτων.

Επόμενα βήματα

Στη συνέχεια, δημοσιεύστε την εφαρμογή του παράγοντα σας στο Microsoft admin center ώστε να μπορείτε να δημιουργείτε παραδείγματα παράγοντα και χρήστες από αυτή.

Δημοσίευση του παράγοντά σας

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

Παρακολούθηση απόδοσης: Χρησιμοποιήστε εργαλεία παρατηρησιμότητας για να παρακολουθείτε τη συμπεριφορά του παράγοντα και να βελτιστοποιείτε τις απαντήσεις.
Προσθέστε περισσότερα εργαλεία: Εξερευνήστε τον κατάλογο εργαλείων για να επεκτείνετε τις δυνατότητες του παράγοντά σας.
Επανάληψη και βελτίωση: Ενημερώστε τον κώδικα του παράγοντα σας, αναπτύξτε ξανά και αναδημοσιεύστε (θυμηθείτε να αυξήσετε τον αριθμό έκδοσης!).
Επεκτείνετε τη χρήση του παράγοντα στον οργανισμό σας: Μοιραστείτε τις επιτυχίες του παράγοντα σας για να προωθήσετε την υιοθέτηση.

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

Αυτή η ενότητα περιγράφει συνηθισμένα προβλήματα κατά την ανάπτυξη παραγόντων στο Azure.

Φιλοδώρημα

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

Η εντολή ανάπτυξης αποτυγχάνει

Σύμπτωμα: Η ανάπτυξη στο Azure αποτυγχάνει.

Κοινές αιτίες και λύσεις:

Σφάλματα κατασκευής

Κάντε rebuild το έργο τοπικά για να δείτε λεπτομερή σφάλματα build:
```
# .NET
dotnet clean
dotnet build --verbosity detailed

# Python
uv build

# Node.js
npm install
npm run build
```
Ο έλεγχος ταυτότητας Azure έληξε

Είσοδος ξανά στο Azure:
```
az login
az account show  # Verify correct subscription
```
Η εφαρμογή Ιστού δεν δημιουργήθηκε

Εμφανίστε τις εφαρμογές Ιστού για να επιβεβαιώσετε ότι ο στόχος υπάρχει:
```
# List Web Apps in resource group
az webapp list --resource-group <your-resource-group> --output table
```
Ελέγξτε τα αρχεία καταγραφής ανάπτυξης

Χρησιμοποιήστε την az webapp log tail εντολή για να προβάλετε λεπτομερή αρχεία καταγραφής ανάπτυξης:
```
az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
```

Επαλήθευση:

# Web App should be running
az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
# Expected: "Running"

Η web εφαρμογή έχει σταματήσει

Σύμπτωμα: Η ανάπτυξη είναι επιτυχής, αλλά η εφαρμογή web δεν εκτελείται.

Λύση: Χρησιμοποιήστε az webapp start και az webapp show για να ξεκινήσετε την εφαρμογή web και επαληθεύστε ότι εκτελείται.

# Start the Web App
az webapp start --name <your-app> --resource-group <your-resource-group>

# Verify it's running
az webapp show --name <your-app> --resource-group <your-resource-group> --query state

Η εφαρμογή καταρρέει κατά την εκκίνηση

Σύμπτωμα: Η εφαρμογή Web ξεκινά αλλά καταρρέει αμέσως; τα αρχεία καταγραφής εμφανίζουν σφάλματα.

Συνήθεις αιτίες:

Εξαρτήσεις που λείπουν - Ελέγξτε την έξοδο του build για να βεβαιωθείτε ότι περιλαμβάνει όλα τα απαιτούμενα πακέτα.
Έλλειψη μεταβλητών περιβάλλοντος - Επαληθεύστε ότι όλες οι απαιτούμενες μεταβλητές περιβάλλοντος έχουν ρυθμιστεί.
Αναντιστοιχία έκδοσης χρόνου εκτέλεσης - Βεβαιωθείτε ότι η έκδοση του Azure runtime αντιστοιχεί στο περιβάλλον ανάπτυξής σας.
Σφάλματα κώδικα - Ελέγξτε τα αρχεία καταγραφής εφαρμογών για συγκεκριμένες εξαιρέσεις.

Λύση: Χρησιμοποιήστε τις εντολές az webapp log tail, az webapp config appsettings list και az webapp config appsettings set για να προβάλετε τα αρχεία καταγραφής, να ελέγξετε τις μεταβλητές περιβάλλοντος και να ορίσετε τις μεταβλητές που λείπουν.

# View application logs
az webapp log tail --name <your-app> --resource-group <your-resource-group>

# Check environment variables
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Manually set a missing variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings KEY=VALUE

404 στο τελικό σημείο μηνυμάτων

Σύμπτωμα: Η εφαρμογή ιστού εκτελείται, αλλά το τελικό σημείο /api/messages επιστρέφει 404.

Λύση:

Επαληθεύστε τη διαμόρφωση δρομολόγησης στον κώδικα του παράγοντα σας.
Βεβαιωθείτε ότι ο handler του τελικού σημείου είναι σωστά καταχωρημένος.
Βεβαιωθείτε ότι έχει καθοριστεί το σωστό σημείο εισόδου στην ανάπτυξη.

Δοκιμάστε το τελικό σημείο στέλνοντας μια GET αίτηση στη διεύθυνση URL. Χρησιμοποιήστε την az webapp config showεντολή για να ελέγξετε τη ρύθμιση παραμέτρων της web εφαρμογής.

curl https://<your-app-name>.azurewebsites.net/api/messages
az webapp config show --name <your-app> --resource-group <your-resource-group>

Οι μεταβλητές περιβάλλοντος δεν έχουν οριστεί ή είναι λανθασμένες

Σύμπτωμα: Η ανάπτυξη ολοκληρώνεται με επιτυχία, αλλά ο παράγοντας δεν λειτουργεί· εμφανίζονται σφάλματα για ελλείπουσα ρύθμιση παραμέτρων στα αρχεία καταγραφής.

Λύση: Επαληθεύστε και ενημερώστε τις μεταβλητές περιβάλλοντος. Χρησιμοποιήστε τις εντολές az webapp config appsettings list και az webapp config appsettings set για να ελέγξετε τις μεταβλητές περιβάλλοντος και να προσθέσετε τις ελλείπουσες μεταβλητές. Στη συνέχεια, επαναδιαθέστε.

# List all app settings
az webapp config appsettings list --name <your-app> --resource-group <your-resource-group>

# Set a specific variable
az webapp config appsettings set --name <your-app> --resource-group <your-resource-group> --settings API_KEY=your-value

Το build είναι επιτυχές τοπικά, αλλά αποτυγχάνει στο Azure

Σύμπτωμα: Το build του κώδικα ολοκληρώνεται επιτυχώς στον υπολογιστή σας, αλλά αποτυγχάνει κατά την ανάπτυξη στο Azure.

Λύσεις

Ελέγξτε για ειδικές πλατφόρμας εξαρτήσεις
- Ορισμένα πακέτα έχουν εκδόσεις για συγκεκριμένες πλατφόρμες.
- Βεβαιωθείτε ότι οι εξαρτήσεις υποστηρίζουν το Linux (τα Azure Web Apps εκτελούνται στο Linux από προεπιλογή).
Επαλήθευση αντιστοίχισης εκδόσεων χρόνου εκτέλεσης

Εκτελέστε αυτές τις εντολές:
```
# Check your local version
dotnet --version  # .NET
node --version    # Node.js
python --version  # Python
```
Συγκρίνετε με τον χρόνο εκτέλεσης Azure στην Πύλη: Ρυθμίσεις>Διαμόρφωση>Γενικές ρυθμίσεις>Ρυθμίσεις στοίβας.

Για πρόσθετη βοήθεια, δείτε: Αντιμετώπιση προβλημάτων τελικού σημείου ανταλλαγής μηνυμάτων.

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-07-30