Conseils généraux pour utiliser des exemples d'applications Wingtip Tickets SaaS

Article
06/02/2023

Cet article contient des conseils généraux sur l'exécution d'exemples d'applications Wingtip Tickets SaaS utilisant Azure SQL Database.

Télécharger et débloquer les scripts Wingtip Tickets SaaS

Le contenu exécutable (scripts, DLL) peut être bloqué par Windows lorsque des fichiers zip sont téléchargés à partir d’une source externe puis extraits. Lorsque vous extrayez les scripts d’un fichier zip, suivez les étapes ci-dessous pour débloquer le fichier .zip avant l’extraction. Cela garantit que les scripts sont autorisés à s’exécuter.

Accédez au référentiel GitHub Wingtip Tickets SaaS pour connaître le modèle de client de base de données à explorer :
Cliquez sur Cloner ou télécharger.
Cliquez sur Télécharger ZIP et enregistrez le fichier.
Cliquez avec le bouton droit sur le fichier zip et sélectionnez Propriétés. Le nom du fichier zip représentera le nom du référentiel. (ex. : WingtipTicketsSaaS-DbPerTenant-master.zip)
Sous l’onglet Général, sélectionnez Débloquer.
Cliquez sur OK.
Procédez à l’extraction des fichiers.

Les scripts se trouvent dans le dossier ..\Learning Modules.

Utilisation des scripts PowerShell de Wingtip Tickets

Pour tirer le meilleur parti de l’exemple, vous devez approfondir les scripts fournis. Utilisez des points d’arrêt et parcourez les scripts pour examiner les détails de l’implémentation des différents motifs SaaS. Pour parcourir facilement les scripts et les modules fournis afin d’acquérir une compréhension optimale de ceux-ci, nous vous recommandons d’utiliser PowerShell ISE.

Mettre à jour le fichier de configuration pour votre déploiement

Modifiez le fichier UserConfig.psm1 avec le groupe de ressources et la valeur utilisateur que vous avez définis durant le déploiement :

Ouvrez l’environnement ISE PowerShell puis chargez ...\Learning Modules\UserConfig.psm1.
Mettez à jour ResourceGroupName et Name avec les valeurs spécifiques à votre déploiement (lignes 10 et 11 uniquement).
Enregistrez les modifications !

La définition de ces valeurs ici vous évite simplement d’avoir à mettre à jour ces valeurs spécifiques du déploiement dans chaque script.

Exécuter les scripts en appuyant sur F5

Plusieurs scripts utilisent $PSScriptRoot pour parcourir les dossiers, et $PSScriptRoot est évalué uniquement lors de l’exécution de scripts en appuyant sur F5. La mise en surbrillance et l’exécution d’une sélection (F8) pouvant entraîner des erreurs, appuyez sur F5 lors de l’exécution des scripts.

Parcourir les scripts pour examiner l’implémentation

La meilleure façon de comprendre les scripts consiste à les parcourir pour voir ce qu’ils font. Extrayez les scripts Demo- inclus, qui présentent un flux de travail de haut niveau facile pour suivre. Les scripts Demo- présentent les étapes nécessaires à l’accomplissement de chaque tâche. Par conséquent, définissez des points d’arrêt, puis approfondissez les appels individuels pour voir les détails d’implémentation des différents modèles SaaS.

Conseils pour l’exploration et le parcours des scripts PowerShell :

Ouvrez les scripts Demo- dans le PowerShell ISE.
Exécutez ou continuez à exécuter le script à l’aide de la touche F5 (l’utilisation de la touche F8 n’est pas conseillée, car $PSScriptRoot n’est pas évalué lors de l’exécution des sélections d’un script).
Placez des points d’arrêt en cliquant ou en sélectionnant une ligne et en appuyant sur F9.
Survolez l’appel d’une fonction ou d’un script à l’aide de la touche F10.
Parcourez l’appel d’une fonction ou d’un script à l’aide de la touche F11.
Sortez de l’appel actuel d’une fonction ou d’un script en appuyant sur MAJ + F11.

Explorez le schéma de base de données et exécutez des requêtes SQL à l’aide de SSMS

Utilisez SQL Server Management Studio (SSMS) pour vous connecter et parcourir les bases de données et les serveurs de l’application.

Le déploiement dispose initialement de locataires et de serveurs de catalogue auxquels se connecter. Les noms de serveurs dépendent du modèle de client de base de données (voir ci-dessous pour plus les détails).

Application autonome : serveurs pour chaque locataire (ex. contosoconcerthall-<Utilisateur> serveur) et catalog-sa-<Utilisateur>
Base de données par locataire : serveurs tenants1-dpt-<User> et catalog-dpt-<User>
Base de données mutualisée : serveurs tenants1-mt-<Utilisateur> et catalog-mt-<Utilisateur>

Pour garantir une connexion de démonstration réussie, tous serveurs ont une règle de pare-feu autorisant toutes les adresses IP.

Ouvrez SSMS et connectez-vous aux clients. Le nom du serveur dépend du modèle de client de base de données que vous avez sélectionné (voir ci-dessous pour plus les détails) :
- Application autonome : serveurs de locataires individuels (ex. contosoconcerthall-<Utilisateur>.database.windows.net)
- Base de données par client :tenants1-dpt-<Utilisateur>.database.windows.net
- Base de données mutualisée :tenants1-mt-<Utilisateur>.database.windows.net
Cliquez sur Connexion>Moteur de base de données... :
Les informations d’identification de la version de démonstration sont : nom d’utilisateur = developer, mot de passe = P@ssword1.

L'image ci-dessous montre l'ouverture d'une session pour le modèle Base de données par client.
Répétez les étapes 2 et 3 et connectez-vous au serveur de catalogue (voir ci-dessous pour connaître le nom des serveurs spécifiques en fonction du modèle de client de base de données sélectionné)
- Application autonome :catalog-sa-<Utilisateur>.database.windows.net
- Base de données par client :catalog-dpt-<Utilisateur>.database.windows.net
- Base de données mutualisée :catalog-mt-<Utilisateur>.database.windows.net

Une fois la connexion établie, vous devez voir tous les serveurs. Votre liste des bases de données peut être différente, selon les clients que vous avez approvisionnés.

L'image ci-dessous montre l'ouverture d'une session pour le modèle Base de données par client.

object explorer

Partager via