Déploiement de PowerShell sur Google Cloud Platform

Les commandes PowerShell sont utilisées pour déployer Unified Access Gateway 2103 ou version ultérieure pour Compute Engine dans Google Cloud Platform.

Procédure

1. Préparer la machine cliente
2. Préparer l'environnement Google Cloud Platform
3. Charger l'image Unified Access Gateway sur Google Cloud Platform
4. Préparer un fichier .ini pour le déploiement sur Google Cloud Platform
5. Déployer sur Compute Engine

Étape 1 : Préparer la machine cliente pour le déploiement de PowerShell

Installez les utilitaires Google Cloud sur la machine cliente.

1. Installez gsutil. Pour obtenir des instructions sur l'installation de l'outil gsutil sur Windows et Ubuntu, reportez-vous à la section Installation de gsutil dans le cadre de l'interface de ligne de commande Google Cloud dans la documentation de Google Cloud.

2. Pour la machine Windows, exécutez la commande PowerShell suivante avec des droits d'administration.

   Install-Package 7Zip4PowerShell
   

Systèmes d'exploitation recommandés pour l'exécution du script de déploiement de PowerShell

Le tableau suivant répertorie les systèmes d'exploitation à partir desquels un déploiement d'Unified Access Gateway basé sur PowerShell dans Google Cloud Platform peut être exécuté. Cela ne fait pas référence au système d'exploitation du dispositif Unified Access Gateway proprement dit.

Étape 2 : Préparer l'environnement Google Cloud Platform

Utilisez un projet Google Cloud. Ce projet doit être configuré avec des réseaux VPC, les réseaux de sous-réseau correspondants et des règles de pare-feu. Pour plus d'informations, reportez-vous à la documentation de Google Cloud.

Conditions préalables

• Assurez-vous que vous connaissez les concepts de Google Cloud Platform.
• Assurez-vous que vous disposez des autorisations nécessaires pour créer ou modifier des ressources telles que des images, un réseau VPC, un sous-réseau, des règles de pare-feu, etc., dans le projet Google Cloud.
• Vous devez activer l'API Compute Engine.

Procédure

1. Utilisez un projet Google Cloud.

   Option	Action
   Nouveau projet	Dans Google Cloud Console, accédez à la page Sélecteur de projet. Créez un projet Google Cloud.
   Projet existant	Si un projet est déjà disponible et actif, vous pouvez utiliser le projet existant.

2. Créez un réseau Virtual Private Cloud (VPC) pour chaque carte réseau.

   Chaque carte réseau sur Unified Access Gateway utilise un réseau VPC unique et un sous-réseau dans ce réseau.

   Si vous choisissez de ne pas créer de réseau VPC, vous ne pouvez déployer qu'un dispositif Unified Access Gateway à carte réseau unique. Lorsqu'il est déployé dans Compute Engine, le dispositif Unified Access Gateway utilise le réseau VPC par défaut disponible dans Google Cloud Platform.

   Par exemple, sur l'image suivante, deux réseaux VPC, uag-front-vpc et uag-back-vpc, sont créés dans Google Cloud Console. Ces réseaux VPC disposent respectivement des sous-réseaux uag-front-network et uag-back-network. Vous pouvez déployer un dispositif Unified Access Gateway à deux cartes réseau pour utiliser ces deux sous-réseaux pour l'accès Internet frontal et un réseau de sous-réseau distinct pour les connexions principales.

   

   Remarque : vous pouvez également configurer Unified Access Gateway avec des réseaux VPC partagés. Dans ce cas, les instances d'Unified Access Gateway déployées sur le projet de service sont attachées aux réseaux VPC partagés créés et gérés sur le projet hôte. Vous pouvez configurer chaque interface réseau (NIC) sur Unified Access Gateway indépendamment pour utiliser un réseau VPC partagé ou un réseau VPC local. Pour plus d'informations, reportez-vous à la documentation Configuration d'un VPC partagé sur Google Cloud.

3. Notez le nom du sous-réseau créé.

   Le nom de sous-réseau dans un réseau VPC est utilisé dans le fichier .ini lors du déploiement d'Unified Access Gateway à l'aide de PowerShell.

4. Pour autoriser l'accès des ports TCP et UDP aux dispositifs Unified Access Gateway dans le VPC accessible par Internet, créez le nombre requis d'entrées de pare-feu.

   Important : l'accès à distance à Unified Access Gateway via SSH sur le port TCP 22 depuis Internet doit être soigneusement restreint sur le pare-feu. Si l'accès via SSH est nécessaire, la règle de pare-feu doit autoriser cet accès à partir d'une adresse IP source spécifique uniquement ou à partir d'une machine virtuelle JumpBox dans le cloud à partir duquel l'accès peut être contrôlé.

   Par exemple, sur l'image Google Cloud Console suivante, une règle de pare-feu nommée uag-horizon-protocols est créée dans le réseau VPC connecté à Internet uag-front-vpc. Cette règle de pare-feu s'applique à toutes les instances connectées au réseau uag-front-vpc et autorise le trafic TCP et UDP entrant sur les ports spécifiés à partir de l'Internet public.

   

Étape 3 : Charger l'image Unified Access Gateway sur Google Cloud Platform

Pour déployer une instance d'Unified Access Gateway sur Compute Engine, vous devez charger une image de disque du dispositif Unified Access Gateway sur Google Cloud Platform.

1. Dans Omnissa Customer Connect, accédez au fichier Unified Access Gateway (UAG) pour vSphere, AWS, Google Cloud et cliquez sur TÉLÉCHARGER MAINTENANT.
   Un fichier ZIP euc-unified-access-gateway-x.x.x.xxxxxxxxx.ova est téléchargé sur votre machine locale.

2. Ouvrez une fenêtre de commande PowerShell et exécutez la commande suivante pour extraire le fichier .vmdk du fichier .ova précédemment téléchargé.

   • ova-filename est le fichier image .ova téléchargé à partir de Customer Connect.
   • target-location est l'emplacement vers lequel le fichier .vmdk est extrait.

   Windows	Ubuntu
   expand-7zip ova-filename target-location Par exemple, euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova est le fichier téléchargé, où 22-12 est le numéro de version et 42741890 est le numéro de build. Pour extraire le fichier .vmdk dans C:\temp, exécutez la commande suivante : expand-7zip C:\temp\euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova C:\temp\	tar -xvf ova-filename Par exemple, tar -xvf euc-unified-access-gateway-22.12.0.0-42741890_OVF10.ova

3. Définissez les variables suivantes.

   • $gcImageFile est le nom du fichier .vmdk extrait à l'étape 2.
   • $gcImageFolder est le chemin d'accès au dossier du fichier .vmdk. Par exemple :

   
   $gcImageFolder="C:\temp"
   $gcImageFile="euc-unified-access-gateway-22.12.0.0-42741890-system.vmdk"
   $gcBucket="uag-appliance-images"
   $gcImageName=$gcImageFile.Replace("-system.vmdk","").Replace(".", "-")
   gcloud auth login
   gcloud config set project "my-project"
   
   

4. Créez un compartiment de stockage Google Cloud.

   Remarque : vous pouvez également déployer Unified Access Gateway avec une image de calcul hébergée sur un autre projet Google Cloud. Dans ce cas, spécifiez le nom de l'image de calcul ($gcImageName) et l'ID de projet d'hébergement lors du déploiement d'Unified Access Gateway.

   Exécutez cette commande pour créer un compartiment de stockage dans le même projet.

   gsutil mb -l us-east1 gs://$gcBucket
   

   Exécutez cette commande pour créer un compartiment de stockage dans un autre projet.

   gsutil mb -l us-east1 gs://$gcBucket -p my-image-hosting-project
   

5. Chargez l'image .vmdk dans le compartiment de stockage Google Cloud à l'aide de la commande suivante :

   gsutil cp $gcImageFolder\$gcImageFile gs://$gcBucket
   

6. Créez l'image du dispositif dans Compute Engine à partir du fichier .vmdk chargé.

   Exécutez cette commande pour importer une image dans le même projet.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk
   

   Exécutez cette commande pour importer l'image dans un autre projet.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --project my-image-hosting-project
   

   Remarque : lorsque vous importez une image de calcul, vous pouvez spécifier le sous-réseau à utiliser pour les machines virtuelles temporaires créées par l'outil d'importation. Utilisez l'indicateur --subnet, comme indiqué dans l'exemple suivant.

   gcloud compute images import $gcImageName --source-file gs://$gcBucket/$gcImageFile --data-disk --subnet default
   

   Pour plus d'informations sur ces commandes, reportez-vous à la documentation SDK Google Cloud.

   Compte tenu de l'exemple mentionné aux étapes précédentes, l'image du dispositif créée dans Compute Engine est euc-unified-access-gateway-22-12-0-0-42741890 où 22-12 est le numéro de version et 42741890 est le numéro de build.

Étape 4 : Préparer un fichier .ini pour le déploiement sur Google Cloud Platform

Le script de déploiement PowerShell Compute Engine pour Unified Access Gateway lit tous les paramètres de configuration à partir d'un fichier de configuration .ini. Cette section décrit le format de fichier .ini et montre des exemples de paramètres qui peuvent être utilisés pour le déploiement.

La plupart des sections du fichier .ini sont identiques aux paramètres .ini standard pour Unified Access Gateway pris en charge pour tous les autres déploiements de l'hyperviseur. Pour plus d'informations sur le fichier .ini, reportez-vous à la section Utilisation de PowerShell pour déployer le dispositif Unified Access Gateway.

1. Configurez les paramètres requis dans la section [Général]. Reportez-vous à la section Paramètres de déploiement PowerShell.

   Remarque : pour les déploiements de Google Cloud Platform, les paramètres suivants de la section [Général] ne sont pas utilisés :

   • diskMode
   • ds
   • folder
   • netInternet
   • netManagementNetwork
   • netmask0, netmask1, netmask2
   • netBackendNetwork
   • source
   • target
   • ip0, defaultGateway, netmask0, ipmode0
   • v6ip0, v6ipprefix0, v6DefaultGateway

2. Dans le fichier .ini, ajoutez un nouveau groupe, [GoogleCloud] et les paramètres nécessaires spécifiques à Google Cloud Platform.

Le tableau suivant répertorie les paramètres (Nom de la valeur) qui sont requis pour le déploiement de Google Cloud Platform.

sharedVpcForSubnet0=true
sharedVpcForSubnet1=false
sharedVpcForSubnet2=false

Exemple 1 : définition de fichier INI pour le déploiement d'Unified Access Gateway sur Google Cloud Platform

[General]
name=uag1
deploymentOption=onenic
sshEnabled=true

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
zone=us-central1-a
subnet0=uag-front-network

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

Exemple 2 : définition de fichier INI pour le déploiement d'Unified Access Gateway sur Google Cloud Platform

[General]
name=uag2
deploymentOption=twonic
sshEnabled=true
routes1=10.20.0.0/16 10.2.0.1

[GoogleCloud]
projectId=my-project
imageName=euc-unified-access-gateway-22-12-0-0-42741890
imageProjectId=my-image-hosting-project
zone=us-central1-a
vpcHostProjectId=my-sharedvpc-host-project
subnet0=uag-front-network
sharedVpcForSubnet0=true
subnet1=uag-back-network
sharedVpcForSubnet1=false

[Horizon]
proxyDestinationUrl=https://myhorizon.example.com

Étape 5 : Déployer sur Compute Engine

Vous pouvez déployer Unified Access Gateway sur Compute Engine à l'aide de la commande PowerShell uagdeploygce.ps1. Cette commande récupère tous les paramètres de configuration d'un fichier .ini et déploie une instance d'Unified Access Gateway.

Si une instance existante dans Compute Engine porte le même nom que celui spécifié dans la section Général du fichier .ini, le script PowerShell supprime l'instance existante lors du déploiement et crée une instance d'Unified Access Gateway avec le même nom. Ce remplacement est utile lors de la mise à niveau d'un dispositif Unified Access Gateway ou pour redéployer celui-ci avec les paramètres mis à jour.

1. Dans Omnissa Customer Connect, accédez au fichier Scripts PowerShell d'Unified Access Gateway (UAG) et cliquez sur TÉLÉCHARGER MAINTENANT.
   Un fichier ZIP uagdeploy-xx.xx.x.x-xxxxxxxx est téléchargé sur votre machine locale.

2. Extrayez les fichiers du fichier ZIP. Assurez-vous que les scripts PowerShell suivants sont disponibles sur votre machine.
   uagdeploygce.ps1 et uagdeploy.psm1 sur votre machine Windows.

3. Démarrez une fenêtre de commande PowerShell et remplacez le répertoire par le dossier contenant les scripts téléchargés.

4. Pour déployer Unified Access Gateway sur Compute Engine, procédez comme suit :

   1. Si vous effectuez une mise à niveau vers une version ultérieure d'Unified Access Gateway, modifiez le fichier .ini pour mettre à jour le paramètre imageName vers le nouveau nom de l'image chargé vers Compute Engine dans l'une des tâches précédentes.

      Tous les autres paramètres de configuration dans le fichier .ini doivent rester les mêmes.

   2. Exécutez la commande suivante selon que vous choisissez le mode interactif ou non interactif :

      Mode	Commande
      Interactif	.\uagdeploygce.ps1 <ini-filename>.ini <ini-filename> est le nom du fichier .ini préparé dans les tâches antérieures. Par exemple : .\uagdeploygce.ps1 uag1.ini uag1.ini est le nom du fichier utilisé dans les tâches antérieures.
      Non interactif	.\uagdeploygce.ps1 <ini-filename> <root-pwd> <admin-pwd> <ceip-yes-no> .\uagdeploygce.ps1 <ini-filename> <secret> <admin-pwd> yes <ini-filename> est le nom du fichier .ini préparé dans les tâches antérieures. Si des mots de passe sont spécifiés sur la ligne de commande, comme indiqué dans la commande, utilisez la commande PowerShell Clear-History après le déploiement d'Unified Access Gateway. Si le mot de passe est faible, le déploiement échoue. Le mot de passe doit contenir l'un des caractères suivants : ! @ # $ % * ( ).

      Si vous exécutez de nouveau la commande uagdeploygce.ps1, l'instance précédente d'Unified Access Gateway et les ressources associées sont supprimées et remplacées par une nouvelle instance portant le même nom. Le nouveau fichier .ini doit disposer de tous les paramètres de configuration requis pour que le dispositif Unified Access Gateway soit prêt pour la production lors du premier démarrage.

Pour plus d'informations sur les exigences en matière de mots de passe de l'utilisateur racine et de l'administrateur, reportez-vous à la section Exigences en matière de mots de passe.

Étapes suivantes

Une fois Unified Access Gateway déployé sur Compute Engine et tous les paramètres appliqués, vous devez supprimer les métadonnées utilisées pour appliquer les paramètres de configuration du dispositif Unified Access Gateway dans Google Cloud. Pour supprimer les métadonnées, utilisez les commandes suivantes, comme indiqué dans l'exemple :

$uagName=uag1
$zone=us-central1-a
$projectId=my-project
gcloud compute instances remove-metadata $uagName --zone=$zone --project $projectId --keys "user-data"