Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Configurez Res Ready AMIs
Avec Amazon Machine Images (AMIs) compatible RES, vous pouvez préinstaller les dépendances RES pour les instances de bureau virtuel (VDIs) sur votre compte personnalisé. AMIs L'utilisation de RES Ready AMIs améliore les temps de démarrage des instances VDI à l'aide des images préfabriquées. À l'aide EC2 d'Image Builder, vous pouvez créer et enregistrer vos piles de logiciels AMIs en tant que nouvelles. Pour plus d'informations sur Image Builder, consultez le guide de l'utilisateur d'Image Builder.
Avant de commencer, vous devez déployer la dernière version de RES.
Préparer le rôle IAM pour accéder à l'environnement RES
Pour accéder au service d'environnement RES depuis EC2 Image Builder, vous devez créer ou modifier un rôle IAM appelé RES- EC2InstanceProfileForImageBuilder. Pour plus d'informations sur la configuration d'un rôle IAM à utiliser dans Image Builder, consultez AWS Identity and Access Management (IAM) dans le guide de l'utilisateur d'Image Builder.
Votre rôle nécessite :
-
Les relations de confiance incluent le EC2 service Amazon.
-
Amazon SSMManaged InstanceCore et ses EC2 InstanceProfileForImageBuilder politiques.
-
Politique RES personnalisée avec accès limité à DynamoDB et Amazon S3 à l'environnement RES déployé.
(Cette politique peut être soit un document de politique géré par le client, soit un document de politique intégré au client.)
Entité relationnelle de confiance :
- JSON
-
-
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ec2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
Politique RES :
- JSON
-
-
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "RESDynamoDBAccess",
"Effect": "Allow",
"Action": "dynamodb:GetItem",
"Resource": "arn:aws:dynamodb:us-east-1
:{AWS-Account-ID}
:table/{RES-EnvironmentName}
.cluster-settings",
"Condition": {
"ForAllValues:StringLike": {
"dynamodb:LeadingKeys": [
"global-settings.gpu_settings.*",
"global-settings.package_config.*",
"cluster-manager.host_modules.*",
"identity-provider.cognito.enable_native_user_login"
]
}
}
},
{
"Sid": "RESS3Access",
"Effect": "Allow",
"Action": "s3:GetObject",
"Resource": [
"arn:aws:s3:::{RES-EnvironmentName}
-cluster-{AWS-Region}
-{AWS-Account-ID}
/idea/vdc/res-ready-install-script-packages/*",
"arn:aws:s3:::research-engineering-studio-{AWS-Region}
/host_modules/*"
]
}
]
}
Créer un composant EC2 Image Builder
Suivez les instructions pour créer un composant à l'aide de la console Image Builder dans le guide de l'utilisateur d'Image Builder.
Entrez les détails de votre composant :
-
Dans Type, choisissez Build.
-
Pour le système d'exploitation Image (OS), choisissez Linux ou Windows.
-
Pour Nom du composant, entrez un nom significatif tel queresearch-and-engineering-studio-vdi-<operating-system>
.
-
Entrez le numéro de version de votre composant et ajoutez éventuellement une description.
-
Pour le document de définition, entrez le fichier de définition suivant. Si vous rencontrez des erreurs, le fichier YAML est sensible à l'espace et en est la cause la plus probable.
- Linux
-
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
# with the License. A copy of the License is located at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
# and limitations under the License.
name: research-and-engineering-studio-vdi-linux
description: An RES EC2 Image Builder component to install required RES software dependencies for Linux VDI.
schemaVersion: 1.0
parameters:
- AWSAccountID:
type: string
description: RES Environment AWS Account ID
- RESEnvName:
type: string
description: RES Environment Name
- RESEnvRegion:
type: string
description: RES Environment Region
- RESEnvReleaseVersion:
type: string
description: RES Release Version
phases:
- name: build
steps:
- name: PrepareRESBootstrap
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- 'mkdir -p /root/bootstrap/logs'
- 'mkdir -p /root/bootstrap/latest'
- name: DownloadRESLinuxInstallPackage
action: S3Download
onFailure: Abort
maxAttempts: 3
inputs:
- source: 's3://{{ RESEnvName }}-cluster-{{ RESEnvRegion }}-{{ AWSAccountID }}/idea/vdc/res-ready-install-script-packages/linux/res_linux_install_{{ RESEnvReleaseVersion }}.tar.gz'
destination: '/root/bootstrap/res_linux_install_{{ RESEnvReleaseVersion }}.tar.gz'
expectedBucketOwner: '{{ AWSAccountID }}'
- name: RunInstallScript
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- 'tar -xvf {{ build.DownloadRESLinuxInstallPackage.inputs[0].destination }} -C /root/bootstrap/latest'
- '/bin/bash /root/bootstrap/latest/virtual-desktop-host-linux/install.sh -r {{ RESEnvRegion }} -n {{ RESEnvName }} -g NONE'
- name: FirstReboot
action: Reboot
onFailure: Abort
maxAttempts: 3
inputs:
delaySeconds: 0
- name: RunInstallPostRebootScript
action: ExecuteBash
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- '/bin/bash /root/bootstrap/latest/virtual-desktop-host-linux/install_post_reboot.sh'
- name: SecondReboot
action: Reboot
onFailure: Abort
maxAttempts: 3
inputs:
delaySeconds: 0
- Windows
-
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
# with the License. A copy of the License is located at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
# and limitations under the License.
name: research-and-engineering-studio-vdi-windows
description: An RES EC2 Image Builder component to install required RES software dependencies for Windows VDI.
schemaVersion: 1.0
parameters:
- AWSAccountID:
type: string
description: RES Environment AWS Account ID
- RESEnvName:
type: string
description: RES Environment Name
- RESEnvRegion:
type: string
description: RES Environment Region
- RESEnvReleaseVersion:
type: string
description: RES Release Version
phases:
- name: build
steps:
- name: CreateRESBootstrapFolder
action: CreateFolder
onFailure: Abort
maxAttempts: 3
inputs:
- path: 'C:\Users\Administrator\RES\Bootstrap'
overwrite: true
- name: DownloadRESWindowsInstallPackage
action: S3Download
onFailure: Abort
maxAttempts: 3
inputs:
- source: 's3://{{ RESEnvName }}-cluster-{{ RESEnvRegion }}-{{ AWSAccountID }}/idea/vdc/res-ready-install-script-packages/windows/res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
destination: '{{ build.CreateRESBootstrapFolder.inputs[0].path }}\res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
expectedBucketOwner: '{{ AWSAccountID }}'
- name: RunInstallScript
action: ExecutePowerShell
onFailure: Abort
maxAttempts: 3
inputs:
commands:
- 'cd {{ build.CreateRESBootstrapFolder.inputs[0].path }}'
- 'Tar -xf res_windows_install_{{ RESEnvReleaseVersion }}.tar.gz'
- 'Import-Module .\virtual-desktop-host-windows\Install.ps1'
- 'Install-WindowsEC2Instance'
- name: Reboot
action: Reboot
onFailure: Abort
maxAttempts: 3
inputs:
delaySeconds: 0
-
Créez des balises facultatives et choisissez Créer un composant.
Préparez votre recette EC2 Image Builder
Une recette EC2 Image Builder définit l'image de base à utiliser comme point de départ pour créer une nouvelle image, ainsi que l'ensemble des composants que vous ajoutez pour personnaliser votre image et vérifier que tout fonctionne comme prévu. Vous devez créer ou modifier une recette pour construire l'AMI cible avec les dépendances logicielles RES nécessaires. Pour plus d'informations sur les recettes, voir Gérer les recettes.
RES prend en charge les systèmes d'exploitation d'image suivants :
- Create a new recipe
-
-
Ouvrez la console EC2 Image Builder à l'adressehttps://console.aws.amazon.com/imagebuilder.
-
Sous Ressources enregistrées, choisissez Image recipes.
-
Choisissez Créer une recette d'image.
-
Entrez un nom unique et un numéro de version.
-
Sélectionnez une image de base prise en charge par RES.
-
Sous Configuration de l'instance, installez un agent SSM s'il n'en existe pas un préinstallé. Entrez les informations dans Données utilisateur et toute autre donnée utilisateur nécessaire.
Pour plus d'informations sur l'installation d'un agent SSM, voir :
-
Pour les recettes basées sur Linux, ajoutez le composant de aws-cli-version-2-linux
compilation géré par Amazon à la recette. Les scripts d'installation RES utilisent le AWS CLI pour fournir un accès VDI aux valeurs de configuration des paramètres du cluster DynamoDB. Windows n'a pas besoin de ce composant.
-
Ajoutez le composant EC2 Image Builder créé pour votre environnement Linux ou Windows et entrez les valeurs de paramètres requises. Les paramètres suivants sont obligatoires : AWSAccount ID, RESEnv Nom, RESEnv Région et RESEnvReleaseVersion.
Pour les environnements Linux, vous devez ajouter ces composants afin que le composant de aws-cli-version-2-linux
compilation soit ajouté en premier.
-
(Recommandé) Ajoutez le composant de simple-boot-test-<linux-or-windows>
test géré par Amazon pour vérifier que l'AMI peut être lancée. Il s'agit d'une recommandation minimale. Vous pouvez sélectionner d'autres composants de test qui répondent à vos exigences.
-
Complétez les sections facultatives si nécessaire, ajoutez les autres composants souhaités et choisissez Créer une recette.
- Modify a recipe
-
Si vous possédez déjà une recette EC2 Image Builder, vous pouvez l'utiliser en ajoutant les composants suivants :
-
Pour les recettes basées sur Linux, ajoutez le composant de aws-cli-version-2-linux
compilation géré par Amazon à la recette. Les scripts d'installation RES utilisent le AWS CLI pour fournir un accès VDI aux valeurs de configuration des paramètres du cluster DynamoDB. Windows n'a pas besoin de ce composant.
-
Ajoutez le composant EC2 Image Builder créé pour votre environnement Linux ou Windows et entrez les valeurs de paramètres requises. Les paramètres suivants sont obligatoires : AWSAccount ID, RESEnv Nom, RESEnv Région et RESEnvReleaseVersion.
Pour les environnements Linux, vous devez ajouter ces composants afin que le composant de aws-cli-version-2-linux
compilation soit ajouté en premier.
-
Complétez les sections facultatives si nécessaire, ajoutez les autres composants souhaités et choisissez Créer une recette.
Vous pouvez utiliser les configurations d'infrastructure pour spécifier l' EC2 infrastructure Amazon utilisée par Image Builder pour créer et tester votre image Image Builder. Pour une utilisation avec RES, vous pouvez choisir de créer une nouvelle configuration d'infrastructure ou d'utiliser une configuration existante.
Pour configurer votre infrastructure Image Builder :
-
Pour le rôle IAM, entrez le rôle que vous avez configuré précédemment. Préparer le rôle IAM pour accéder à l'environnement RES
-
Pour le type d'instance, choisissez un type avec au moins 4 Go de mémoire et compatible avec l'architecture AMI de base que vous avez choisie. Consultez la section Types d' EC2 instances Amazon.
-
Pour les VPC, les sous-réseaux et les groupes de sécurité, vous devez autoriser l'accès à Internet pour télécharger des packages logiciels. L'accès doit également être autorisé à la table cluster-settings
DynamoDB et au compartiment de cluster Amazon S3 de l'environnement RES.
Configurer le pipeline d'images Image Builder
Le pipeline d'images Image Builder assemble l'image de base, les composants pour la création et les tests, la configuration de l'infrastructure et les paramètres de distribution. Pour configurer un pipeline d'images prêt pour RES AMIs, vous pouvez choisir de créer un nouveau pipeline ou d'utiliser un pipeline existant. Pour plus d'informations, consultez la section Création et mise à jour de pipelines d'images AMI dans le guide de l'utilisateur d'Image Builder.
- Create a new Image Builder pipeline
-
-
Ouvrez la console Image Builder à l'adressehttps://console.aws.amazon.com/imagebuilder.
-
Dans le volet de navigation, choisissez Image pipelines.
-
Choisissez Créer un pipeline d'images.
-
Spécifiez les détails de votre pipeline en saisissant un nom unique, une description facultative, un calendrier et une fréquence.
-
Pour Choisir une recette, choisissez Utiliser une recette existante et sélectionnez la recette créée dansPréparez votre recette EC2 Image Builder. Vérifiez que les détails de votre recette sont corrects.
-
Pour Définir le processus de création d'image, choisissez le flux de travail par défaut ou personnalisé selon le cas d'utilisation. Dans la plupart des cas, les flux de travail par défaut sont suffisants. Pour plus d'informations, consultez Configurer les flux de travail d'imagerie pour votre pipeline EC2 Image Builder.
-
Pour Définir la configuration de l'infrastructure, choisissez Choisir la configuration d'infrastructure existante et sélectionnez la configuration d'infrastructure créée dansConfiguration de l'infrastructure EC2 Image Builder. Vérifiez que les détails de votre infrastructure sont corrects.
-
Pour Définir les paramètres de distribution, choisissez Créer les paramètres de distribution à l'aide des paramètres de distribution par défaut du service. L'image de sortie doit se trouver dans le même environnement RES Région AWS que celui de votre environnement RES. En utilisant les paramètres par défaut du service, l'image sera créée dans la région où Image Builder est utilisé.
-
Passez en revue les détails du pipeline et choisissez Create pipeline.
- Modify an existing Image Builder pipeline
-
Exécuter le pipeline d'images Image Builder
Pour produire l'image de sortie configurée, vous devez lancer le pipeline d'images. Le processus de création peut prendre jusqu'à une heure selon le nombre de composants contenus dans la recette d'image.
Enregistrez une nouvelle pile logicielle dans RES