Cela constitue une introduction à Image Management, en présentant son objectif, ses avantages et ses caractéristiques importantes.

Le Image Management Le module est une implémentation étendue de Packer de Hashicorp. Cela permet aux administrateurs de créer des images standardisées et cohérentes sur plusieurs plateformes. Avec Image Management, vous n’avez pas besoin d’écrire des configurations basées sur le JSON pour plusieurs images d’infrastructure.

Regardez notre Vidéo YouTube Pour une visite guidée visuelle

Caractéristiques principales

Image Management vous permet d'utiliser vos scripts d'installation personnalisés et étend l'implémentation de Packer grâce aux fonctionnalités suivantes :

• Créer des groupes de provisionneurs
• Créer des rôles de provisionneur
• Utiliser les configurations DSC PowerShell lors de la création d'images (hébergées et indépendantes) Configuration Management)
• Utilisez les paquets, les groupes et les rôles de l’outil PowerShell AppDeployment Toolkit (avec Gestion des applications)

Cas d'utilisation

• Delivery continue
• Alignement DEV/ACC/PRD
• Création de démonstrations
• Images dorées

Principales avantages

Notre Image Management module :

• Permet de lancer des machines entièrement provisionnées et configurées en quelques minutes, de manière répétée et cohérente – créez différentes images pour les environnements de développement, d’acceptation ou de production ou utilisez une seule pour toutes les phases.
• Détermine des images de développeur prêtes à l’emploi ou est utilisable dans les environnements Citrix pour créer des images « golden » – car en créant des images identiques pour plusieurs plateformes, vous pouvez exécuter la production sur AWS, la phase de test/qualité dans un cloud privé comme OpenStack et le développement dans des solutions de virtualisation de bureau telles que VMware ou VirtualBox.
• Installe et configure tout le logiciel d’une machine au moment de la création de l’image – si des bugs surviennent dans ces scripts, ils seront détectés dès le début plutôt que lors de la production.
• Implémentation des scripts Pester (ou similaires) pour tester vos machines contre un état défini

The post About Image Management appeared first on XOAP.

Image Management

Pour commencer à utiliser Image Management, il n'y a qu'un seul préalable : une connexion fonctionnelle à votre environnement. Configurez votre connexion en accédant à Connexions, puis cliquez sur Ajouter une nouvelle connexion Un bouton dans le coin supérieur droit.

Dans le panneau déroulant, sélectionnez la connexion Type et Fournisseur. Remplissez les informations requises restantes et cliquez Confirmer Pour sauvegarder votre connexion.

Si vous avez besoin d'assistance pour configurer vos identifiants d'accès, veuillez consulter la section « Configuration des identifiants d'accès ». Connectez votre documentation d’infrastructure.

Dans les sections suivantes, vous trouverez plus d'informations concernant les autorisations requises pour votre infrastructure. Veuillez noter que ces autorisations sont les suivantes : droits minimums Il fallait créer Définitions d'images.

Si vous comptez utiliser la même connexion pour Actions scénarisées, Les autorisations requises peuvent varier en fonction de la situation d’utilisation spécifique.

AWS

Pour créer une image personnalisée, il faut Le VPC par défaut doit être disponible dans le compte AWS que vous utilisez.

De plus, vous devez assigner des autorisations appropriées Les autorisations IAM à l’utilisateur spécifié dans la connexion. Au minimum, les permissions suivantes sont requises :

#Codeblock

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:AttachVolume",
        "ec2:AuthorizeSecurityGroupIngress",
        "ec2:CopyImage",
        "ec2:CreateImage",
        "ec2:CreateKeyPair",
        "ec2:CreateSecurityGroup",
        "ec2:CreateSnapshot",
        "ec2:CreateTags",
        "ec2:CreateVolume",
        "ec2:DeleteKeyPair",
        "ec2:DeleteSecurityGroup",
        "ec2:DeleteSnapshot",
        "ec2:DeleteVolume",
        "ec2:DeregisterImage",
        "ec2:DescribeImageAttribute",
        "ec2:DescribeImages",
        "ec2:DescribeInstances",
        "ec2:DescribeInstanceStatus",
        "ec2:DescribeRegions",
        "ec2:DescribeSecurityGroups",
        "ec2:DescribeSnapshots",
        "ec2:DescribeSubnets",
        "ec2:DescribeTags",
        "ec2:DescribeVolumes",
        "ec2:DetachVolume",
        "ec2:GetPasswordData",
        "ec2:ModifyImageAttribute",
        "ec2:ModifyInstanceAttribute",
        "ec2:ModifySnapshotAttribute",
        "ec2:RegisterImage",
        "ec2:RunInstances",
        "ec2:StopInstances",
        "ec2:TerminateInstances"
      ],
      "Resource": "*"
    }
  ]
}

#EndOfCodeblock

En savoir plus sur les autorisations requises ici.

L'azur

Pour créer des images sur Azure, assurez-vous que les conditions préalables suivantes sont remplies : vous devez créer un Principal Service Avec le rôle Contributeur, vous disposez de l’accès à votre abonnement Azure. Utilisez l’Azure CLI pour générer le Service Principal.

Format de commande

#Codeblock
az ad sp create-for-rbac \
  --name [ServicePrincipalName] \
  — rôle Contributeur \
  –scopes /subscriptions/[SubscriptionId] \
  – ans 1
#EndOfCodeblock

Exemple de commande

#Codeblock

az ad sp create-for-rbac \
  – nom xoap-image-principal \
  — rôle Contributeur \
  –scopes /subscriptions/xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  – ans 1

#EndOfCodeblock

Échappement de commande

#Codeblock

{
  "appId": "[ClientId (Guid)]",
  "displayName": "xoap-image-principal",
  "name": "http://xoap-image-principal",
  "password": "[ClientSecret]",
  "tenant": "[TenantId (Guid)]"
}

#EndOfCodeblock

En utilisant cette sortie, vous pouvez désormais configurer votre connexion dans XOAP :

• ID d’abonnement : xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
• Numéro d'identification du locataire : [TenantId (GUID)]
• Identifiant du client : [appId]
• Secret du client : [mot de passe]

En savoir plus sur les autorisations requises ici.

Google

Le fichier que vous devez télécharger est un Google Cloud Fichier de clés de compte de service dans JSON format. Vous pouvez générer et télécharger Voici comment ça marche :

1. Ouvrir Google Cloud Console: https://console.cloud.google.com/iam-admin/serviceaccounts.
2. Sélectionnez votre projet dans le menu déroulant en haut à gauche.
3. Créer ou sélectionner un compte de service : si vous n’en avez pas encore, cliquez sur “Créer un compte de service” sous “IAM&Admin” menu. Donnez-lui un nom et une description optionnelle.
4. Attribuez les rôles requis (voir ci-dessous la liste complète).
5. Après avoir créé ou sélectionné un compte de service :
   • Cliquez sur ⋮ (trois points) à côté du nom du compte de service → Gestion des touches
   • Sous l'égide de “ Les clés ” dans la section « Ajouter une clé », cliquez sur « Ajouter une clé ». Créer une nouvelle clé
   • Choisissez JSON, puis cliquez Créer
6. Le fichier sera téléchargé automatiquement – c’est le fichier que vous devez télécharger dans XOAP pour vous authentifier avec Google Cloud.

Rôles IAM nécessaires pour que le Packer puisse créer des images

Pour permettre à l’utilisateur de créer des images personnalisées avec Packer, vous devez assigner au moins les rôles suivants :

En savoir plus sur les autorisations requises ici.

vSphere

Pour intégrer XOAP avec VMware vSphere Pour les builds d'images, créez un Rôle personnalisé vSphere Cela inclut uniquement les privilèges nécessaires à XOAP pour effectuer ses opérations. Affectez cette autorité à un compte de service dédié pour garantir que XOAP dispose d’un accès à la moindre échelle à l’infrastructure vSphere.

Privilèges requis

Clone l’élément par défaut Lecture uniquement Activez le rôle vSphere et ajoutez les privilèges suivants :

The post Prerequisites appeared first on XOAP.

Guide rapide

C’est la dernière étape de la création d’images. Si vous n’avez pas encore configuré votre Connexion, Systèmes d'exploitation, Configuration du constructeur ou Provisionner un rôle, Veuillez le faire avant de procéder.

Créer une nouvelle définition d’image

1. Dans le coin supérieur droit, cliquez sur + Nouvelle image.
2. Entrez tous les paramètres requis et cliquez Économiser.
3. Cliquez avec le bouton droit de la souris sur la définition d’image nouvellement créée et sélectionnez Exécuter créer les images.

Mettre à jour une définition d’image existante

1. Cliquez avec le bouton droit sur la définition de l'image et sélectionnez Régions.
2. Ajustez les paramètres selon les besoins et cliquez Économiser.
3. Exécutez l'opération « Image Definition » pour créer une nouvelle version d'image avec la configuration mise à jour.

Supprimer une définition d’image

1. Pour supprimer une définition d’image, cliquez-droit dessus et sélectionnez Supprimer.
2. Cela supprime la définition d’image dans XOAP, mais toutes les versions d’image précédemment créées restent dans votre environnement.

Informations supplémentaires utiles

Exigence de connecteur :

Le Connecteur Dans un environnement image-based, une définition d’image est requise pour les déploiements sécurisés dans les environnements cloud et sur site. Consultez notre documentation pour obtenir des instructions sur la manière de déployer le connecteur XOAP sur votre machine.

Éléments de base :

Nous fournissons des exemples Configurations de constructeur, Systèmes d'exploitation, et Provisionner des rôles Dans votre Workspace, sous forme de modèles de démarrage rapide. Ils peuvent ne pas correspondre entièrement à votre environnement ; n’hésitez pas donc pas à les modifier ou à créer les vôtres.

Règles et parcours :

Pour consulter le journal de l’exécution précédente, cliquez sur Statut badge. Le suivi en temps réel et l'arrêt d'une exécution d'image peuvent être effectués depuis Courses voir.

Courses temporaires :

Si une course se déroule Arrêté, les fichiers temporaires créés lors de cette exécution ne sont pas supprimés de votre environnement. Pour Échec ou Succès Les fichiers temporaires sont supprimés automatiquement après l’exécution.

Documentation technique

La définition de l’image est la dernière et la plus cruciale étape du processus de création d’image. C’est là que vous associez toutes les composantes préalablement configurées—Provisionner un rôle, Système d'exploitation, et Configuration du constructeur—en un seul et même projet.

En combinant ces éléments, vous définissez exactement la manière dont l’image de machine virtuelle sera créée, quel système d’exploitation elle utilisera, comment elle sera configurée et dans quel environnement elle sera déployée (par exemple, AWS, Azure, etc.).

Dans XOAP, cette étape assure que votre image est créée de manière cohérente selon votre configuration sélectionnée et prête à être déployée ou automatisée.

L'interface vous permet de :

• Attribuer un nom et une description à la définition d'image
• Sélectionnez des tags pour la catégorisation ou le filtrage
• Choisissez le fournisseur de constructeur et la configuration spécifique du constructeur
• Choisissez une image de système d'exploitation de base
• Régler la relation entre le rôle de provisionneur approprié (qui comprend tous les scripts, tâches et configurations)
• Définir un appareil Connector XOAP pour les définitions d'image sur site ou dans des environnements cloud sécurisés
• Configurer la définition de l'image lors de l'exécution

Exécuter ou planifier les compilations d'images

En exécutant une définition d'image, vous lancerez le processus de création de l'image. Vous pouvez suivre l'avancement de cette tâche en cliquant sur Courses Un bouton dans le coin supérieur droit. Cela ouvre un panneau latéral présentant les courses en cours.

En cliquant sur « Activer les journaux », vous pouvez suivre les journaux de compilation en cours et surveiller l’avancement en temps réel.

Il existe plusieurs statuts possibles pour une exécution d'une définition d'image :

Pas de points marqués – La définition de l’image n’a pas encore été exécutée
En attente – Le parcours est en attente et commencera lorsque les ressources seront disponibles.
La course à pied – Le processus de création de l’image est actuellement en cours.
Succès – L’image a été construite et terminée avec succès sans erreurs
Échec – Le processus de création de l’image a rencontré une erreur et n’a pas pu être terminé.
Arrêté – La création de l’image a été arrêtée avec succès par un utilisateur et n’a pas été terminée.

Le processus de définition de l'image peut prendre entre quelques minutes et quelques heures.

Cela dépend principalement du nombre de lecteurs d'images utilisés et du système d'exploitation de base sélectionné. Si vous souhaitez obtenir plus de détails concernant une définition d'image spécifique, cliquez sur « Détails » dans le menu « Actions ».

Pour les définitions d'image Windows dans les environnements cloud, le commandement sysprep est exécuté automatiquement à la fin de l'exécution de la définition d'image. Pour les environnements sur site, vous devez l'ajouter manuellement dans votre rôle Provisioner.

Les provisionneurs Sysprep que nous exécutons en tant que script PowerShell automatiquement dans le cloud sont disponibles sur notre repo GitHub : https://github.com/xoap-io/xoap-packer-templates.

Voici un exemple de script que vous pouvez utiliser pour le sysprep sur les définitions d’image sur site. Pour l’utiliser, téléchargez un script dans la zone ressources, puis attribuez le script à l’endroit dernier de votre définition.

Scénario

Set-StrictMode -Version Dernière
$ProgressPreference = 'SilentlyContinue'
$ErrorActionPreference = 'Stop'

# Configurer l’enregistrement des fichiers locaux sur C:\xoap-logs
Essayez {
    $LogDir = 'C:\xoap-logs'
    si (-not (Test-Path $LogDir)) {
        New-Item -Path $LogDir -ItemType Directory -Force | Out-Null
    }
    
    $scriptName = [IO.Path]::GetFileNameWithoutExtension($PSCommandPath)
    $timestamp = Get-Date -Format 'yyyyMMdd-HHmmss'
    $LogFile = Join-Path $LogDir "$scriptName-$timestamp.log"
    
    Début de la transcription -Path $LogFile -Append | Out-Null
    Write-Host "Enregistrement vers: $LogFile"
} catch {
    Warning d'erreur "Impossible de lancer l'enregistrement du transcript sur C:\xoap-logs : $($_.Exception.Message)"
}

# Fonction de journalisation simple
fonction Write-Log {
    param($Message)
    $timestamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'
    Write-Host "[$timestamp] $Message"
}

l'enchaînement {
    Log de l'écriture "ERREUR: $_"
    Log de l'écriture "ERREUR: $($_.ScriptStackTrace)"
    Log de l'écriture "ERREUR EXCEPTION: $($_.Exception.ToString())"
    Essayez { Stop-Transcript | Out-Null } catch {}
    Sortie 1
}

Essayez {
    Log de l'écriture 'Début de la dernière étape de nettoyage et de préparation du système'
     
    # Défragmenter le disque système
    Écriture du log 'Optimisation du lecteur système...'
    Essayez {
        Optimiser-Volume -DriveLetter C -Défragmenter -Verbose:$false
        Écriture du log : ' Optimisation du disque système terminée '
    } catch {
        Log de l'écriture "Avertissement : Impossible d'optimiser le lecteur système : $($_.Exception.Message)"
    }
    
    Log de l'écriture 'La dernière étape de nettoyage terminée, préparant le système pour le sysprep...'
      
    # Arrêter la transcription avant le sysprep
    Essayez { Stop-Transcript | Out-Null } catch {}
    
    # Préparer le commandement sysprep
    $sysprepPath = Join-Path $env:WINDIR "System32\Sysprep\sysprep.exe"
    $sysprepArgs = @('/generalize', '/oobe')
    
    Log de l'écriture "Exécutant le processus de création de système avec les arguments suivants : $($sysprepArgs -join ' ')"
    Log de l'écriture "Cela mettra fin au fonctionnement du système une fois terminé"
    
        # Consultez si le fichier sysprep.exe existe
        si (Test-Path $sysprepPath) {
            # Exécutez sysprep en utilisant Start-Process pour une meilleure gestion des erreurs
            $process = Start-Process -FilePath $sysprepPath -ArgumentList $sysprepArgs -Wait -PassThru
            $exitCode = code d'exutoire de la $procédure
            si ($null -eq $exitCode) {
                # Retour à $LASTEXITCODE si ExitCode n'est pas défini
                $exitCode = $LASTEXITCODE
            }
            si (code_$sortie - ≠ 0) {
                Log de l'écriture "Le processus de Sysprep a échoué avec le code d'exit: $exitCode"
                sortie code_ $sortie
            }
        } Sinon,
            Log de détection d'erreur "L'exécutable Sysprep n'a pas été trouvé à $sysprepPath"
            sortie 1
        }
    
} catch {
    Log de l'écriture "Erreur critique lors du nettoyage final : $($_.Exception.Message)".
    Essayez { Stop-Transcript | Out-Null } catch {}
    jeter
}

La planification des tâches Image Definition offre plusieurs avantages opérationnels et stratégiques. En automatisant l’exécution des compilations d’images à des intervalles définis, vous éliminez la nécessité d’interventions manuelles et réduisez le risque d’erreur humaine.

Les versions planifiées contribuent à maintenir la cohérence entre les environnements en garantissant que les configurations et les mises à jour logicielles les plus récentes soient régulièrement intégrées dans vos images. Cela est particulièrement important en matière de conformité et de sécurité, car cela garantit que les images mises à jour et corrigées sont toujours disponibles.

De plus, la planification des mises à jour en dehors des heures de pointe permet d’optimiser l’utilisation des ressources et d’éviter d’affecter d’autres charges de travail. Enfin, les mises à jour planifiées régulièrement améliorent la préparation aux scénarios de reprise après sinistre en garantissant que les images de machines propres et à jour soient facilement accessibles.

Il existe deux façons de planifier les exécutions de la définition d’image :

1. En créant un nouveau planning
2. En modifiant un calendrier existant

Pour gérer l’une ou l’autre option, naviguez vers Horaires section.
Si vous souhaitez créer un nouveau planning, cliquez sur Nouvelle grille de programmation Le bouton se trouve dans le coin supérieur droit. Dans la première étape, indiquez un nom et définissez les paramètres de calendrier (p. ex., fréquence, heure de début). Dans la deuxième étape, sélectionnez les définitions d’image que vous souhaitez assigner à ce calendrier. Une définition d’image peut être associée à plusieurs calendriers.

Si vous souhaitez attribuer une définition d'image à un horaire actuel, Choisissez le horaire souhaité dans la liste, cliquez sur menu à trois points, puis sélectionnez Régions. Dans la vue de détails, sélectionnez les définitions d’image que vous souhaitez inclure et cliquez sur Économiser.

Localisez votre image créée dans votre hyperviseur ou hyperscaler

Une fois une exécution terminée avec succès, l’image créée est disponible dans votre environnement. Les images utilisent le nom défini dans la définition de l’image, avec un suffixe de version ajouté pour chaque exécution. Par exemple, si votre définition d’image s’appelle Windows11-BaseImage, Avec ces runs, on va créer des images comme Windows11-BaseImage-v1, Windows11-BaseImage-v2, et ainsi de suite. Si la création de l’image échoue, aucune image n’est créée. La méthode exacte pour localiser l’image dépend de votre environnement cible.

Microsoft Azure

L'emplacement des images créées dans Azure à l'aide de XOAP Image Management dépend de la base de données sélectionnée.Type uilder durant la création du constructeur. Dans la configuration du constructeur, vous pouvez choisir entre Azure géré et Galerie Azure.

1. Azure Managed (Images gérées)
   Si le type de constructeur sélectionné est Azure géré, l'image sera créée comme une image standard Image gérée.
   - Localisation :
   Portail Azure → Images
   - Comportement :
   L'image est stockée au niveau régional et est disponible uniquement dans la région où elle a été créée.
   - Cas d'utilisation :
   Cette approche est recommandée pour les déploiements simples, les tests ou les scénarios de proof-of-concept.
2. Azure Gallery (Galerie d'images partagées)
   Si le type de constructeur sélectionné est Galerie Azure, l'image sera stockée dans un Galerie d'images partagées (SIG).
   - Localisation :
   Portail Azure → Galerie d'images partagées
   - Comportement :
   L'image prend en charge la versionnage, peut être répliquée dans plusieurs régions et est évolutive pour les scénarios d'entreprise.
   - Cas d'utilisation :
   Idéal pour les charges de travail ou les environnements de production nécessitant une redondance régionale et une gestion du cycle de vie des images.

Amazon Web Services (AWS)

Les images créées via XOAP sont stockées sous la forme de AMIs (Images de machine Amazon).

Pour localiser :

1. Allez à la Console AWS.
2. Naviguez jusqu'à EC2 → AMI (sous « Images » dans le menu gauche).
3. Assurez-vous de modifier le filtre de « Propriété Amazon » à « Propriété moi-même ».
4. Rechercher en utilisant le AMI ID ou le nom restitué par l'exécution de la définition d'image XOAP (par exemple ami-xxxxxxxxxxxxxxxxx).

Par défaut, les AMI sont privé — ils ne sont visibles que pour le compte qui les a créés.
Pour rendre un AMI accessible depuis un autre compte AWS, vous devez : Partagez-le explicitement.
Suivez ces étapes sur le compte où l’AMI a été créé :

1. Ouvrir EC2 → AMI (dans la région où l’AMI a été créé, par exemple, eu-central-1).
2. Localisez l'AMI (par exemple, ami-0839804dea557cd2b).
3. Sélectionnez l’AMI et cliquez Actions → Modifier les permissions de l’image.
4. Ajoutez le ID d’utilisateur AWS du compte du destinataire.
5. Cliquez sur Économiser.

Une fois partagé, l’AMI apparaîtra sous la rubrique “Images privées”Filtrez dans le tableau de bord EC2 du destinataire.

Plateforme Google Cloud (GCP)

Les images XOAP sur GCP sont stockées sous Compute Engine → Images.

Pour localiser :

1. Allez à la Google Cloud Console.
2. Naviguez jusqu'à Compute Engine → Images.
3. Filtrer par projet ou utiliser la barre de recherche pour trouver le nom de l’image généré par XOAP.
4. Les images personnalisées peuvent être regroupées par familles d'images ou Entrées individuelles Selon la configuration de la build

Résoudre les problèmes liés aux compilations d’images ou aux erreurs de lancement

Lors de la création d’une image à l’aide de XOAP Image Management, des problèmes peuvent généralement surgir dans l’un des trois domaines suivants :

1. Connexions – Connexion à la cloud configurée incorrectement (par exemple, identités invalides ou permissions manquantes).
2. Provisionneurs – Des provisionneurs sélectionnés ou configurés de manière incorrecte, tels que des scripts ou des outils qui échouent lors de l’exécution.
3. Configuration du constructeur – Paramètres du constructeur mal configurés (par exemple, région invalide, paramètres d’image manquants).

Tous les trois types de problèmes sont reflétés dans Les logs de la définition de l'image sont exécutés.

Pour identifier rapidement le problème :

• Accédez à l’onglet Définitions d'images table.
• Cliquez sur État (la dernière course) pour la définition de l'image correspondante.
• Un panneau latéral s'affiche, indiquant journal de la dernière course.
• Revoir le journal pour trouver la ligne d’erreur et prendre les mesures correctives nécessaires.

La révision de ces journaux constitue la méthode la plus efficace pour dépanner les problèmes et garantir le succès de la création de votre image.

Pour les journaux des précédentes sessions, cliquez sur le menu à trois points situé à côté de la définition de l’image et sélectionnez « Détails ». Faites défiler jusqu’à la section « Sessions précédentes » et cliquez sur l’état de la session souhaitée pour afficher son journal.

Durant le processus de création d’images, il est possible d’identifier et de résoudre les problèmes en temps réel. Les compilations d’images actives sont visibles dans la section « Exécutions », située en haut à droite de la page « Définitions d’image ».

Pour suivre le processus en cours :

• Cliquez sur l’icône de journal à côté de la création de l’image pour ouvrir la vue journalisée en direct.
• Les logs sont diffusés en temps réel, les dernières entrées apparaissant en haut.

Cela vous permet de :

• Suivez les étapes de provisionnement au fur et à mesure qu'elles se déroulent.
• Identifiez rapidement les fournisseurs en cours d’exécution qui peuvent provoquer des temps d’arrêt.
• Mettez en œuvre des mesures correctives dès le début, ce qui peut vous permettre de gagner beaucoup de temps lors du dépannage et de la validation.

Cette vue est particulièrement utile pour diagnostiquer les problèmes sans attendre que l’ensemble du build soit terminé.

Sur les VMs de création d’images sur site, les journaux sont généralement stockés localement dans les endroits suivants :

• Fichiers temporaires : C:\Windows\Temp et %TEMP% (par exemple, C:\Users\AppData\Local\Temp)
• Logues de dépannage Windows (utilisables pour les problèmes d’installation/mise à jour/sysprep) :
• L'enregistreur d'événements : application et système
• C:\Windows\Logs\DISM\dism.log et C:\Windows\Logs\CBS\CBS.log
• Sysprep : C:\Windows\System32\Sysprep\Panther\setupact.log et setuperr.log

Si vous n’arrivez pas à les retrouver, la raison la plus fréquente est que la VM de build est automatiquement nettoyée après l’exécution (y compris en cas d’échec), de sorte que les journaux locaux sont supprimés avec elle.

Conseil : Si vous arrêtez la mise en œuvre, la VM de build temporaire n’est pas supprimée, vous pouvez donc vous y connecter et récupérer les journaux pour résoudre les problèmes. Une fois l’enquête terminée, n’oubliez pas de supprimer la VM de build temporaire pour éviter de laisser des ressources inutilisées.

Principales causes d'erreurs lors de la création d'images et comment les résoudre

1. Provisions incompatibles – L’utilisation de provisionneurs Linux sur une image basée sur Windows (ou vice versa) entraînera des erreurs. Résolution : Vérifiez les groupes de provisionneurs assignés au rôle sélectionné et éliminez ceux qui ne sont pas pertinents pour le système d’exploitation de l’image.
2. Données d’identification invalides ou paramètres de connexion – Des problèmes de connexion peuvent se produire si les informations d’identification sont incorrectes ou si l’utilisateur ne dispose pas des autorisations suffisantes. Résolution : Revoir la configuration de votre connexion dans la section « Connexions ». Vérifiez que les informations d’identification sont valides et que vous disposez des droits d’accès appropriés.
3. Configuration du constructeur incorrecte – Des erreurs peuvent se produire si la configuration du constructeur fait référence à des ressources inexistantes telles qu'un réseau virtuel ou un groupe de ressources. Résolution : Vérifiez toutes les valeurs dans les paramètres du constructeur, notamment les noms des réseaux et des groupes de ressources.
4. Définition obsolète du système d'exploitation – Les définitions d’images plus anciennes peuvent faire référence à des systèmes d’exploitation obsolètes ou désuets. Résolution : Naviguez vers « Systèmes d’exploitation » et ajoutez la dernière version. Ensuite, dans les détails de la définition de l’image, modifiez la sélection du système d’exploitation à partir de la liste déroulante vers la version la plus récente.

The post Image Definitions appeared first on XOAP.

Guide rapide

La définition de la constructeur définit Où et comment Une image est créée, en fonction de la plateforme ou du fournisseur de cloud sélectionné (par exemple, AWS, Azure, Google Cloud, ou VMware). Lors de la configuration du constructeur, vous pouvez également choisir Connexion utilisé dans votre environnement cloud ou sur site.

Créer une nouvelle configuration du constructeur

1. Dans le coin supérieur droit, cliquez sur + Nouvelle configuration du constructeur.
2. Sélectionnez « Créer une configuration de constructeur pour les images cloud » ou choisissez une configuration spécifique. Configuration de l’éditeur sur site.
3. Entrez tous les paramètres requis et cliquez Confirmer.

Modifier une configuration du constructeur

1. Cliquez avec le bouton droit de la souris sur la configuration du constructeur et sélectionnez Régions.
2. Mettre à jour les paramètres requis et cliquer Économiser

Supprimer une configuration de build

1. Cliquez avec le bouton droit de la souris sur la configuration du constructeur et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Exigence de connecteur :

Si vous n'avez pas encore configuré votre Connexion, Vous pouvez le faire lors de la création du constructeur en cliquant sur + Ajouter une connexion.

Détails généraux :

Dans le cadre de la Ressources générales L’accordéon, tous les paramètres obligatoires sont affichés. Pour les autres paramètres, faites défiler les autres accordéons.

Documentation technique

Le constructeur La définition définit où (quelle plateforme ou fournisseur de cloud) et comment (quelle configuration et quel type d’instance) est utilisée pour créer l’image. Elle représente la couche infrastructure du processus de création d’image et est responsable du lancement de la machine virtuelle de base qui sera ensuite personnalisée par les provisionneurs.

Dans XOAP, lors de la création d’une configuration de buildier, vous spécifiez :

• Fournisseur – par exemple AWS, Azure ou VMware
• Connexion – les identifiants et l’adresse de terminaison utilisés pour accéder à la plateforme
• Région – la localisation cible de la nuage
• Type d'instance – qui définit les ressources de calcul telles que la CPU et la RAM

Ces paramètres combinés indiquent à XOAP comment provisionner l’infrastructure sous-jacente nécessaire à la création de l’image.

Plus d'informations concernant les paramètres supplémentaires que vous pouvez configurer dans la configuration du constructeur sont disponibles aux liens suivants :

• L'azur
• AWS
• Google Cloud
• VMware
• Nutanix

The post Builder Configuration appeared first on XOAP.

Guide rapide

Dans XOAP, le système d'exploitation représente l'image de base qui servira de base pour votre image de machine virtuelle personnalisée.

Ajouter un nouveau système d’exploitation cloud

1. Cliquez sur + Ajouter l’image de base et sélectionnez Nuage.
2. Indiquez le Fournisseur, Région, et Plate-forme les détails.
3. Sélectionnez un ou plusieurs systèmes d'exploitation et cliquez sur Ajouter.

Ajouter un nouveau système d'exploitation sur site

1. Cliquez sur + Ajouter l’image de base et sélectionnez Sur site.
2. Définissez les paramètres liés à l’ISO.
3. Sélectionnez le fichier Autounattend et les fichiers de configuration pour votre système d’exploitation, puis cliquez sur Ajouter.

Modifier un système d’exploitation

1. Cliquez avec le bouton droit de la souris sur « Système d’exploitation » et sélectionnez Régions.
2. Mettre à jour les paramètres configurables et cliquer Économiser.

Supprimer un système d’exploitation

1. Cliquez avec le bouton droit de la souris sur « Système d’exploitation » et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Liste mise à jour de l'OS :

XOAP récupère chaque semaine des listes mises à jour des systèmes d’exploitation auprès des fournisseurs de cloud pris en charge.

Systèmes d'exploitation :

Les systèmes d’exploitation peuvent être désuets et supprimés par les fournisseurs de services cloud, ce qui peut entraîner l’échec des exécutions d’Image Definition. Pour éviter cela, assurez-vous que vos systèmes d’exploitation soient à jour en ajoutant les dernières versions et en mettant à jour vos Image Definitions en conséquence.

Documentation technique

Dans XOAP, le système d’exploitation représente l’image de base qui servira de base pour votre image de machine virtuelle personnalisée. Vous pouvez sélectionner une ou plusieurs versions d’OS auprès de votre fournisseur de cloud (par exemple, Azure, AWS, GCP) pour correspondre à vos besoins d’infrastructure. Cette étape est essentielle car toutes les opérations de provisionnement, de personnalisation et de création de l’image seront effectuées sur cette base OS.

Lors de l’ajout d’un système d’exploitation en nuage dans XOAP, vous définissez :

• Fournisseur – Sélectionnez le fournisseur de cloud ou de plateforme (par exemple, Azure, AWS, Google Cloud...)
• Région – Indiquez la région où l’image de base est disponible
• Détails de la plateforme – Choisissez la version du système d’exploitation, l’architecture (x64/ARM), la génération du hyperviseur et le SKU
• Étiquettes – Ajoutez des étiquettes si vous le souhaitez pour aider à organiser ou catégoriser le système d'exploitation à des fins futures.

Lors de l’ajout d’un système d’exploitation sur site dans XOAP, vous définissez :

• Nom – Nom de votre système d’exploitation. Vous pouvez définir le nom selon votre propre convention de nommage.
• Nom du fichier ISO – fournissez le nom de votre fichier ISO qui sera utilisé comme système d’exploitation de base pour votre définition d’image
• Path ISO – localisation complète de votre fichier ISO
• Checksum ISO – Contre-somme de votre ISO comme fonctionnalité de sécurité supplémentaire
• Autounattend – fichier utilisé pour modifier les paramètres de Windows lors de l’installation. Ce fichier doit être téléchargé dans la zone de ressources XOAP.
• Fichiers d'installation – définit quels fichiers supplémentaires sont montés par XOAP dans la machine virtuelle lors de l’installation du système d’exploitation.

Ces fichiers sont généralement utilisés par l'attendant.xml pour installer des pilotes, des outils ou pour exécuter des scripts PowerShell personnalisés lors du premier démarrage ou immédiatement après celui-ci.

Conseils sur place

Pour Systèmes d'exploitation sur site, XOAP ne n'enregistre pas l'ISO lui-même. Au lieu de cela, vous enregistrez l'ISO en lui fournissant chemin et Contrôle de checksum, et la mise en place de l’infrastructure (hyperviseur/stockage) doit être possible Accéder à cette ISO en cours d’exécution.

Qu'est-ce que cela signifie en pratique :

• L'ISO est stocké dans votre Stockage du hyperviseur (par exemple, le datastore vSphere / la bibliothèque Hyper-V) ou sur unpartage de fichiers (par exemple, la voie SMB/UNC).
• Les magasins XOAP Les métadonnées sur l’ISO (nom, chemin, checksum) et utilise cette information lors de la création des images.
• Assurez-vous que les composants de build (par exemple, l’hôte exécutant le build en interne) soient Accès au réseau et autorisations Lire l'ISO à partir de la voie spécifiée.

Utilisez Get-FileHash pour générer la somme de contrôle pour le fichier ISO :

Obtenir-FileHash -Path “\fileserver\isos\Windows11_24H2.iso”- Algorithme SHA256. Copiez la valeur Hash retournée dans le champ ISO Checksum de XOAP.

Utilisez des noms de fichiers uniques si vous envisagez de télécharger plusieurs autounattend des fichiers pour le même système d’exploitation (par exemple, différentes langues, environnements, ensembles de pilotes).

Convention d'appellation d'exemple :

• Autounattend_W11_23H2_FR.xml
• Autounattend_W11_23H2_DE.xml
• Autounattend_W11_23H2_WithDrivers.xml

Important : Les ressources non attendues sont renommé lors du processus de déploiement/construction (dans le cadre de la manière dont XOAP met en place les ressources dans la VM temporaire). En raison de cela, avoir Des noms de fichiers distincts dans les ressources XOAP Il est essentiel de les garder gérables et d’éviter toute confusion lors du choix du fichier correct.

Assurez que le fichier Autounattend corresponde au système d’exploitation cible (édition/SKU, architecture, flux d’installation attendu) et référencie tous les fichiers de configuration/drivers en utilisant des chemins valables dans votre processus de configuration.

The post Operating Systems appeared first on XOAP.

Guide rapide

Un rôle de provisionneur dans XOAP est un constructeur de niveau supérieur qui vous permet de regrouper plusieurs Groupes de provisionnement en une seule unité.

Ajouter un nouveau rôle de provisionneur

1. Cliquez sur + Créer un rôle de provisionneur.
2. Entrez les paramètres requis, tels que Nom et Description.
3. Attribuez des groupes de provisionneurs en cliquant sur +Attribuer des groupes de provisionneurs.
4. Cliquez sur « Enregistrer » pour créer la nouvelle fonction de provisionnement.

Modifier un rôle de provisionneur

1. Cliquez avec le bouton droit de la souris sur le rôle de provisionneur et sélectionnez Régions.
2. Mettre à jour les paramètres ou modifier les groupes assignés.
3. Cliquez sur « Enregistrer » pour appliquer les modifications.

Supprimer un rôle de provisionneur

1. Cliquez avec le bouton droit de la souris sur le rôle de provisionneur et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Rôle de provisionneur :

Seul un Le rôle de provisionneur peut être utilisé dans une définition d’image. Le rôle de provisionneur est donc le constructeur de niveau le plus élevé pour exécuter les provisionneurs lors de la création d’images. Vous Impossible Supprimer un rôle de provisionneur si celui-ci est actuellement utilisé dans une définition d’image.

Groupe Provisioner :

Chacun Groupe de provisionnement Il ne peut être ajouté qu'une seule fois à un rôle de provisionneur donné.

Ordre d'exécution :

Lors de la création d'images, les provisionneurs sont exécutés dans l'ordre suivant : de haut en bas Dans le cadre de ce rôle : tous les préposés du premier groupe prennent le premier tour, suivis par le deuxième groupe, le troisième groupe, et ainsi de suite.

Ordre des groupes :

Vous pouvez changer l’ordre des groupes dans un rôle de provisionneur en les glissant et en les déplaçant dans la vue de détails du rôle de provisionneur.

Documentation technique

A Provisionner un rôle Dans XOAP, il s’agit d’un constructeur de niveau supérieur qui vous permet de regrouper plusieurs Groupes de provisionnement en une seule unité. Il définit quels groupes de fournisseurs seront exécutés durant le processus de création de l'image et dans quelle ordre.

Les rôles de provisionneur sont particulièrement utiles lorsque :

• Vous souhaitez réutiliser des ensembles de groupes prédéfinis pour différentes définitions d'image
• Vous devez combiner des séquences complexes de procédures de provisionnement en une unité plus simple à gérer

Lors de la création d’un rôle Provisioner, vous définissez :

• Nom du rôle – une identité unique pour le rôle
• Description – une brève explication de la fonction (par exemple : “ Rejoindre le domaine et appliquer la base de référence ”)
• Tags – des étiquettes facultatives pour aider à catégoriser ou à rechercher les rôles
• Groupes de provisionneurs sélectionnés – Choisissez les groupes qui doivent être exécutés lors de la compilation

Les actions des groupes de provisionneurs dans le cadre d'une même fonction sont exécutées dans l'ordre où ils sont énumérés, et l’ensemble du rôle peut alors être réutilisé dans plusieurs définitions d’image.

Un seul rôle de provisionneur peut être utilisé dans plusieurs définitions d’image, tout comme les groupes de provisionneurs eux-mêmes. Cela favorise la réutilisabilité et la cohérence au sein des builds.

The post Provisioner Roles appeared first on XOAP.

Guide rapide

Un groupe de provisionneurs dans XOAP vous permet d'organiser plusieurs provisionneurs en une seule unité logique.

Ajouter un nouveau groupe de provisionneurs

1. Cliquez sur + Créer un groupe de provisionneurs.
2. Entrez les paramètres requis, tels que Nom et Description.
3. Attribuer des provisionneurs en cliquant + Assigner des provisionneurs.
4. Cliquez sur Économiser créer le nouveau groupe de provisionneurs.

Modifier un groupe de provisionneurs

1. Cliquez avec le bouton droit de la souris sur le groupe de provisionneurs et sélectionnez Régions.
2. Mettre à jour les paramètres ou modifier les fournisseurs assignés.
3. Cliquez sur Économiser appliquer les changements.

Supprimer un groupe de provisionneurs

1. Cliquez avec le bouton droit de la souris sur le groupe de provisionneurs et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Règles du groupe :

Un fournisseur ne peut être ajouté à un même groupe qu'une seule fois, mais le même fournisseur peut appartenir à plusieurs groupes.

Exécution :

Les provisionneurs d'un groupe sont exécutés par de haut en bas.

Ordre des fournisseurs :

Vous pouvez changer l’ordre des fournisseurs au sein d’un groupe de fournisseurs en les glissant et en les déplaçant dans la vue détails du groupe de fournisseurs.

Documentation technique

A Groupe de provisionnement Dans XOAP, vous pouvez organiser plusieurs fournisseurs en un seul groupe. unité unique et logique. Cela est utile pour regrouper les tâches de configuration ou les étapes de configuration liées qui doivent être appliquées ensemble lors du processus de création de l’image.

Les membres du groupe sont exécuté dans l'ordre exact Ils sont listés, ce qui vous donne un contrôle total sur le flux d’exécution. Par exemple, vous pouvez vous assurer qu’un fichier soit copié avant que le script soit exécuté ou que les mises à jour Windows soient exécutées avant un redémarrage.

Lors de la création d’un groupe de fournisseurs, vous définissez :

• Nom du groupe – un nom unique pour une identification facile
• Description – texte facultatif expliquant la raison de la création du groupe
• Tags – pour aider à organiser et filtrer les groupes dans des environnements volumineux
• Fournisseurs sélectionnés – choisissez un ou plusieurs fournisseurs à inclure dans la liste disponible

Les provisionneurs d’un groupe de provisionneurs sont exécutés dans l’ordre dans lequel ils sont listés, et l’ensemble du groupe peut ensuite être réutilisé dans plusieurs rôles de provisionneur. Cela favorise la réutilisabilité et la cohérence au sein des builds.

The post Provisioner Groups appeared first on XOAP.

Guide rapide

Un provisioner est un élément clé du processus de création d'image utilisé pour personnaliser la machine virtuelle après sa création par le constructeur.

Ajouter un nouveau provisionneur

1. Cliquez sur + Créer un provisionneur.
2. Entrez les paramètres requis, tels que Nom et Description.
3. Sélectionnez l'option Type de provisionneur et remplissez tous les paramètres requis.
4. Cliquez sur Économiser créer le nouveau Provisioner.

Modifier un provisionneur

1. Cliquez avec le bouton droit de la souris sur le Provisioner et sélectionnez Régions.
2. Mettez à jour les paramètres du Provisioner selon les besoins.
3. Cliquez sur Économiser appliquer les changements.

Supprimer un provisionneur

1. Cliquez avec le bouton droit de la souris sur le Provisioner et sélectionnez Supprimer.
2. Confirmer la suppression.

Informations supplémentaires utiles

Affectation de plusieurs groupes :

Lors de la création d’un Provisioner, vous pouvez l’ajouter automatiquement à plusieurs groupes de Provisioners.

Gestion combinée :

Provisioners est l’endroit où vous combinez l’XOAP Application Management et Configuration Management modules avec Image Management.

Logiciels spécifiques aux systèmes d'exploitation :

Certains provisionneurs sont uniquement disponibles sous Linux ou uniquement sous Windows. Soyez prudent lors de leur affectation dans des groupes de provisionnement.

Documentation technique

Un provisioner est un élément clé du processus de création d’image utilisé pour personnaliser la machine virtuelle après sa création par le Builder Configuration. Les provisioners permettent d’automatiser les tâches à l’intérieur de la machine virtuelle afin de la préparer pour votre cas d’utilisation spécifique.

Les provisionneurs fonctionnent au sein du système d’exploitation de l’hôte et sont responsables de la modification de l’état du système avant que l’image ne soit finalisée.

Les provisionneurs peuvent être utilisés pour :

• Installer des logiciels (par exemple, Chrome, Office, .NET Framework)
• Copier les fichiers vers des emplacements spécifiques sur la VM
• Configurer les paramètres du système (par exemple, le registre, les services, le réseau)
• Application des bases de référence en matière de durcissement ou de conformité (par exemple, STIG, CIS)
• Exécutez PowerShell, Bash, CMD ou d'autres scripts
• Appliquer des configurations DSC ou rejoindre la machine à un domaine (dans les versions d’entreprise)
• Installer les mises à jour de Windows
• Redémarrer les instances Windows

Dans XOAP, les provisionneurs sont modulaires et réutilisables, ce qui signifie qu'un même provisionneur peut être référencé dans plusieurs définitions d'image. Cela permet une configuration cohérente entre les versions et réduit les doublons lors de la maintenance de votre pipeline d'image.

XOAP prend en charge plusieurs types de provisionneurs, chacun étant conçu pour automatiser un type spécifique de tâche lors de la création d’images :

• Application Group Installer – Installe les applications dans le groupe d’applications sélectionné.
• Application Role Installer – Installe les applications selon le rôle d’application sélectionné.
• Configuration locale DSC – Insérer les fichiers de configuration DSC (Desired State Configuration) locaux dans l’image à appliquer lors ou après la provisionnement. La configuration peut être téléchargée dans la zone de ressources et sélectionnée à partir du menu déroulant.
• Configuration du serveur Pullserver DSC – Implique l’application d’une configuration provenant du Configuration Management module XOAP.
• Fichier – Copie les fichiers du workspace XOAP dans l’image — par exemple, les fichiers de configuration, les scripts ou les ressources.
• Commandes de l'explorateur de fichiers Linux – Exécute un seul commandement inline dans un shell (par exemple apt install, chmod, etc.) sur une machine Linux.
• Script de Shell Linux – Exécute un script complet (.sh) pour configurer les images basées sur Linux avec une logique plus complexe. Vous pouvez sélectionner le script dans la zone « Ressources ».
• Commandes PowerShell – Exécute un commandement PowerShell en une ligne sur des machines sous Windows — utile pour définir des clés de registre, des services, etc.
• Script PowerShell – Exécute un script PowerShell complet pour effectuer des tâches de configuration avancées dans le système d’exploitation Windows. Vous pouvez sélectionner le script dans l’espace « Ressources ».
• Redémarrage de Windows – Génère un redémarrage du système lors de la provisionnement d’images — utile lorsque des modifications de configuration nécessitent un redémarrage pour prendre effet.
• Mise à jour de Windows – Installe les dernières mises à jour de Windows lors du processus de provisionnement pour assurer que l’image soit à jour.

Les provisionneurs peuvent disposer de plusieurs paramètres configurables.

Les fichiers sources pour les types de provisionnement DSC Local Configuration, File, Linux Shell Command et PowerShell Script doivent être téléchargés dans l’espace Ressources de XOAP avant de pouvoir les assigner au provisionneur correspondant.

The post Provisioners appeared first on XOAP.

Si vous définissez des provisionneurs, vous devez toujours définir un délai d’expiration. Cela est important pour éviter une situation où un provisionneur tourne en permanence et bloque le processus de création d’image. Certains provisionneurs disposent de délais d’expiration par défaut, mais vous devez toujours définir un délai d’expiration adapté à votre cas d’utilisation.

The post Best practices appeared first on XOAP.