As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Blocos de aplicações personalizados
As instâncias de streaming de frota elástica utilizam aplicações que são instaladas em arquivos VHD (disco rígido virtual) armazenados em um bucket do Amazon S3 em sua conta. Os blocos de aplicações com empacotamento personalizado oferecem a flexibilidade de criar um arquivo VHD próprio e carregá-lo em um bucket do Amazon S3 em sua conta.
**Topics**
+ [
# Criar o VHD
](create-vhd.md)
+ [
# Crie o script de configuração para o VHD nos aplicativos da Amazon WorkSpaces
](create-setup-script.md)
+ [
# Criar um bloco de aplicações personalizado
](create-app-block.md)
+ [
# Atualizar o bloco de aplicações, o VHD e o script de configuração
](update-app-block.md)
# Criar o VHD
Um VHD é um arquivo único que, quando montado no sistema operacional, é tratado como um disco rígido. O VHD pode ser montado como uma letra de unidade, em um caminho de pasta ou ambos. Quando o VHD é montado, você pode tratá-lo como faria com qualquer outro disco rígido, incluindo a instalação da aplicação ou a cópia dos arquivos necessários para o usuário.
Para criar o bloco de aplicações, você precisará criar o VHD, instalar suas aplicações nele e desconectá-lo. Depois de desconectado, você pode testar seu VHD em outro PC, em uma instância do EC2 ou em um construtor de imagens de WorkSpaces aplicativos para validar se os aplicativos funcionam conforme o esperado. Quando terminar, faça upload para um bucket do Amazon S3 em sua conta e crie o bloco de aplicações.
**nota**
Esta página descreve o uso de um VHD para entregar seu aplicativo; no entanto, a instância de streaming de WorkSpaces aplicativos baixará qualquer objeto do Amazon S3. O objeto que você armazena no Amazon S3 também pode ser um arquivo zip, um instalador de aplicação ou o próprio executável da aplicação. Você pode usar o script de configuração para configurá-lo corretamente na instância de streaming antes que o usuário inicialize sua aplicação.
A instância de streaming do WorkSpaces Applications espera até 120 segundos para que o VHD conclua o download antes que o script de configuração seja executado. Se o VHD não concluir o download dentro desse período, o download será interrompido e o script de configuração não será executado.
Recomendamos um tamanho máximo de 1,5 GB para o VHD. Talvez você consiga reduzir o tamanho do VHD por meio de compressão. Você deve usar o script de configuração para descompactá-lo antes de montá-lo, pois o arquivo precisa ser totalmente baixado do Amazon S3 antes de poder ser montado e a aplicação ser inicializada. VHDsAumente ainda mais o tempo necessário para que o aplicativo seja iniciado e a sessão de streaming comece.
**Como criar um VHD para Microsoft Windows**
1. Em um PC Windows ou uma instância do Amazon Elastic Compute Cloud (Amazon EC2) no Windows, abra um prompt de comando com privilégios administrativos.
1. Inicialize o utilitário **diskpart** da Microsoft inserindo o comando a seguir:
**diskpart**
1. Crie o arquivo VHD não formatado e não inicializado digitando o seguinte comando, onde ** é o tamanho do arquivo VHD, em MB:
**create vdisk file=C:\$1path\$1to\$1new\$1file.vhdx maximum=** type=expandable **
1. Selecione o VHD recém-criado inserindo o comando a seguir:
**select vdisk file=C:\$1path\$1to\$1new\$1file.vhdx**
1. Anexe o VHD recém-criado inserindo o comando a seguir:
**attach vdisk**
1. Inicialize o VHD recém-criado inserindo o comando a seguir:
**convert mbr**
1. Crie a partição primária que abrange todo o VHD inserindo o comando a seguir:
**create partition primary**
1. Formate a partição recém-criada inserindo o comando a seguir:
**format fs=ntfs quick**
1. Você pode montar o VHD recém-criado em uma letra de unidade não utilizada, em um caminho de pasta no volume raiz ou em ambos.
Para montar em uma letra de unidade, insira: **assign letter=****
Para montar em uma pasta, insira: **assign mount=*C:\$1path\$1to\$1empty\$1folder\$1to\$1mount\$1***
**nota**
Para montar em um caminho de pasta, a pasta já deve existir e estar vazia.
1. Agora você pode instalar sua aplicação no VHD usando a letra da unidade ou o caminho de pasta de montagem escolhido na etapa 9.
Depois de concluir a instalação de suas aplicações no VHD, é necessário desconectá-lo antes de carregá-lo com segurança em um bucket do Amazon S3.
**Como desconectar um VHD para Microsoft Windows**
1. Inicialize o utilitário diskpart da Microsoft inserindo o comando a seguir:
**diskpart**
1. Selecione o VHD inserindo o comando a seguir:
**select vdisk file=*C:\$1path\$1to\$1new\$1file.vhdx***
1. Desconecte o VHD inserindo o comando a seguir:
**detach vdisk**
1. O VHD agora foi desanexado e pode ser testado em outro PC com Windows, instância do Amazon EC2 ou WorkSpaces um construtor de imagens de aplicativos.
**Como criar um VHD para Linux**
1. Abra um terminal:
+ Para Amazon Linux 2: use instância EC2, construtor de imagens de WorkSpaces aplicativos ou WorkSpaces desenvolvido com Amazon Linux 2
+ Para o Ubuntu Pro 24.04 LTS: use a instância EC2 ou WorkSpaces desenvolvido com o Ubuntu Pro
1. Crie o arquivo VHD não formatado e não inicializado:
**dd if=/dev/zero of=** bs=** count=1**
1. Adicione um sistema de arquivos ao VHD criado inserindo o comando a seguir:
**sudo mkfs -t ext4 ****
**nota**
Talvez seja exibida uma mensagem informando que o arquivo não é um dispositivo especial de bloco. Você pode continuar mesmo assim.
1. Crie uma pasta vazia para usar como ponto de montagem inserindo o comando a seguir:
**sudo mkdir */path/to/mount/point***
1. Monte o VHD recém-criado em um caminho do sistema de arquivos executando o seguinte comando:
**sudo mount -t auto -o loop ** */path/to/mount/point***
1. Agora você pode instalar sua aplicação no VHD usando o caminho de pasta de montagem escolhido na etapa 4.
**nota**
As permissões padrão para arquivos e pastas criados no VHD podem impedir que usuários não administradores inicializem aplicações ou leiam arquivos. Valide as permissões e altere-as, se necessário.
Depois de concluir a instalação de suas aplicações no VHD, é necessário desconectá-lo antes de carregá-lo com segurança em um bucket do Amazon S3.
**Como desconectar um VHD para Linux**
1. Abra uma sessão de terminal e insira o seguinte comando:
**sudo umount */path/to/mount/point***
1. O VHD já foi desanexado e pode ser testado em outra instância Amazon Linux 2/Ubuntu Pro 24.04 LTS do Amazon EC2, no construtor de imagens do Amazon Linux 2 WorkSpaces Applications ou no Amazon Linux 2/Ubuntu Personal. WorkSpaces
# Crie o script de configuração para o VHD nos aplicativos da Amazon WorkSpaces
WorkSpaces Os aplicativos usam um script de configuração que você fornece para montar o VHD antes da inicialização do aplicativo. Você também pode usar o script de configuração para concluir outras tarefas necessárias para que sua aplicação funcione. Por exemplo, você pode configurar chaves de registro, registrar DLLs, gerenciar pré-requisitos ou modificar o perfil do usuário a partir do script de configuração. WorkSpaces Os aplicativos fornecem exemplos de scripts que você pode usar para montar seu VHD. Você precisará modificar esses scripts de acordo com suas necessidades de VHD e aplicações.
**nota**
Os scripts de configuração não são necessários para blocos de WorkSpaces aplicativos com pacotes de aplicativos. No entanto, você pode fornecer scripts opcionais de pós-configuração para personalizar a instalação da aplicação.
Use os links a seguir para fazer download dos scripts de exemplo:
+ [Script bash do Ubuntu Pro 24.04 LTS e Amazon Linux 2](samples/Linux-mount-vhd-script2.zip)
+ [Script do Microsoft Windows Powershell](samples/Windows-mount-vhd-script3.zip)
**nota**
WorkSpaces Os aplicativos e o sistema operacional Microsoft Windows reservam as letras de unidade A a E. Não monte VHDs ou compartilhe em rede essas letras de unidade.
WorkSpaces Os aplicativos baixam o script de configuração e o VHD em um diretório na instância de streaming da frota e, em seguida, executam o script de configuração. O script de configuração é executado no sistema operacional com todos os direitos de administrador. O script de configuração é executado no `SYSTEM` contexto no Microsoft Windows e como `root` usuário no Amazon Linux 2 ou no Ubuntu Pro 24.04 LTS.
Localização do sistema de arquivos para o VHD e o script de configuração:
+ Ubuntu Pro 24.04 LTS:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
O nome do bloco de aplicações ao qual o VHD e o script de configuração correspondem.
+ Amazon Linux 2:
`/opt/appstream/AppBlocks/appblock-name/`
**`appblock-name` **
O nome do bloco de aplicações ao qual o VHD e o script de configuração correspondem.
+ Microsoft Windows:
`C:\AppStream\AppBlocks\appblock-name\`
**`appblock-name` **
O nome do bloco de aplicações ao qual o VHD e o script de configuração correspondem.
WorkSpaces Os aplicativos mantêm o nome do arquivo como estão no objeto. Por exemplo, se o bloco de aplicações for denominado `MyApps`, com um VHD denominado `apps.vhd` e um script de configuração denominado `mount-apps.ps1`, o caminho completo em uma instância de streaming do Windows será:
+ VHD
`C:\AppStream\AppBlocks\MyApps\apps.vhd`
+ Script de configuração
`C:\AppStream\AppBlocks\MyApps\mount-apps.ps1`
WorkSpaces Os aplicativos capturam o erro padrão e a saída padrão do seu script de configuração quando ele é executado em uma instância de streaming de frota e carrega a saída em um bucket do Amazon S3 em sua conta. Você pode usar esses logs para identificar e resolver possíveis problemas no script de configuração. Os buckets são nomeados em um formato específico da seguinte forma:
```
appstream-logs-region-code-account-id-without-hyphens-random-identifier
```
**`region-code` **
Esse é o código AWS da região no qual a frota elástica é criada.
**`account-id-without-hyphens` **
O identificador AWS da sua conta. O ID aleatório garante que não haja conflitos com outros buckets na região. A primeira parte do nome do bucket, appstream-logs, não é alterada entre contas ou regiões.
Por exemplo, se você criar uma frota elástica na região Oeste dos EUA (Oregon) (us-west-2) na conta número 123456789012 WorkSpaces , a Applications cria um bucket do Amazon S3 dentro da sua conta nessa região com o nome exibido. Somente um administrador com permissões suficientes pode excluir esse bucket.
```
appstream-logs-us-west-2-1234567890123-abcdefg
```
O caminho para a pasta em que os arquivos de log são armazenados no bucket do S3 em sua conta usa a seguinte estrutura:
```
bucket-name/fleet-name/instance-id/appblock-name/
```
**`bucket-name` **
O nome do bucket do Amazon S3 no qual os logs do script de configuração são armazenados. O formato do nome é descrito anteriormente nesta seção.
**`Instance-id` **
O identificador exclusivo da instância de streaming em que o script de configuração foi executado.
**`appblock-name` **
O nome do bloco de aplicações ao qual o script de configuração corresponde.
O exemplo de estrutura de pastas a seguir se aplica a uma sessão de streaming iniciada em `test-fleet`. A sessão é de um Conta da AWS ID de 123456789012, e o nome do appblock é testappblock na região Oeste dos EUA (Oregon) (us-west-2):
`appstream-logs-us-west-2-1234567890123-abcdefg/test-fleet/i-084427ab4a1cff7f5/testappblock/`
Esse exemplo de estrutura de pastas contém um arquivo de log para a saída padrão e um arquivo de log para o erro padrão.
**Topics**
+ [
# Execução do script de configuração de blocos de aplicativos na Amazon WorkSpaces Applications
](script-execution.md)
# Execução do script de configuração de blocos de aplicativos na Amazon WorkSpaces Applications
Os diagramas a seguir indicam em que parte do processo o script de configuração é executado. A ordem de execução depende se a persistência das configurações de aplicações está habilitada na pilha associada à frota elástica.
**nota**
WorkSpaces Os aplicativos usam os detalhes da sua VPC para baixar o VHD e o script de configuração do bucket do Amazon S3. Sua VPC deve fornecer acesso ao bucket do Amazon S3. Para obter mais informações, consulte [Usando endpoints VPC do Amazon S3 para recursos de aplicativos WorkSpaces](managing-network-vpce-iam-policy.md).
A persistência das configurações de aplicações está habilitada:
![\[A persistência das configurações de aplicações está habilitada.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/app-settings-enabled.png)
A persistência das configurações de aplicações está desabilitada:
![\[A persistência das configurações de aplicações está desabilitada.\]](http://docs.aws.amazon.com/pt_br/appstream2/latest/developerguide/images/app-settings-disabled.png)
# Criar um bloco de aplicações personalizado
Você pode usar o console de WorkSpaces aplicativos para criar o recurso de bloco de aplicativos depois de criar e carregar o VHD e o script de configuração em um bucket do S3 no seu. Conta da AWS Para saber mais sobre como armazenar o VHD e o script de configuração em um bucket do Amazon S3, consulte [Armazenar o ícone da aplicação, o script de configuração, o script de sessão e o VHD em um bucket do S3](store-s3-bucket.md).
**nota**
Você deve ter permissões do IAM para realizar a ação `S3:GetObject` nos objetos do VHD e do script de configuração no bucket do Amazon S3 para criar o recurso do bloco de aplicações.
**Como criar o recurso do bloco de aplicações**
1. Abra o console de WorkSpaces aplicativos em [https://console.aws.amazon.com/appstream2](https://console.aws.amazon.com/appstream2).
1. No menu de navegação à esquerda, escolha **Aplicações**, **Bloco de aplicações** e **Criar bloco de aplicações**.
1. Para o empacotamento do bloco de aplicações, selecione **Personalizado**.
1. Em **Detalhes do bloco de aplicações**, digite um identificador de nome exclusivo para o bloco de aplicações. Opcionalmente, também é possível especificar as seguintes opções:
+ **Nome de exibição**: um nome intuitivo para o bloco de aplicações.
+ **Descrição**: uma descrição para o bloco de aplicações.
1. Para **Objeto de disco rígido virtual no S3** em **Configurações do script**, insira o URI do S3 que representa o objeto do VHD ou escolha **Procurar no S3** para navegar até seus buckets do S3 e encontrar o objeto do VHD.
1. Para **Objeto de script de configuração no S3** em **Configurações do script**, insira o URI do S3 que representa o objeto do script de configuração ou escolha **Procurar no S3** para navegar até seus buckets do S3 e encontrar o objeto do script de configuração.
1. Para **Executável do script de configuração** em **Configurações do script**, insira o executável necessário para o seu script de configuração.
**nota**
Se o script de configuração puder ser executado diretamente, insira o nome do arquivo do script de configuração. Se o script de configuração depender de outro executável (por exemplo, Microsoft PowerShell) para ser executado, insira o caminho para esse executável.
Caminho para a Microsoft PowerShell no Microsoft Windows:
`C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe`
1. Opcionalmente, para **Argumentos do executável do script de configuração** em **Configurações do script**, insira os argumentos que precisam ser fornecidos ao executável do script de configuração para executar o script.
**nota**
Se você estiver usando um PowerShell script da Microsoft, deverá especificar o parâmetro “-File” com o nome do seu script de configuração como argumento executável. Além disso, verifique se a política de execução permite que o script seja executado. [Para saber mais, consulte [about\$1Execution\$1Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.2) e O que é? PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/overview?view=powershell-7.2) .
1. Para **Duração da execução em segundos** em **Configurações do script**, insira a duração do tempo limite do seu script de configuração.
**nota**
A duração da execução em segundos é quanto tempo os WorkSpaces aplicativos aguardam a execução do script de configuração antes de continuar. Se o script de configuração não for concluído dentro desse período, um erro será exibido para o usuário e a haverá uma tentativa de inicialização da aplicação. O script de configuração é encerrado após o término da duração da execução.
1. (Opcional) Em **Etiquetas**, crie etiquetas para o recurso do bloco de aplicações.
1. Revise as informações inseridas e escolha **Criar**.
1. Se o bloco de aplicações for criado com êxito, você verá uma mensagem de êxito no topo do console. Se ocorrer um erro, você verá uma mensagem de erro descritiva e precisará tentar criar o bloco de aplicações novamente.
# Atualizar o bloco de aplicações, o VHD e o script de configuração
Os recursos do bloco de aplicações são imutáveis e não permitem que você os altere depois de criados. Se você precisar fazer atualizações compatíveis com versões anteriores no VHD ou no script de configuração, recomendamos que faça upload de uma nova versão do arquivo no bucket do Amazon S3, substituindo a versão atual. As novas sessões de streaming da frota elástica farão download das versões mais recente dos objetos e as usarão.
Se você precisar fazer atualizações incompatíveis com versões anteriores no VHD ou no script de configuração, recomendamos que faça upload delas como novos objetos no bucket do Amazon S3 e crie outro recurso de aplicação e bloco de aplicações. Depois, você pode gerenciar a implantação para os usuários como parte de uma janela de alterações ou outra interrupção.