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
Os blocos de aplicações representam um disco rígido virtual (VHD) armazenado em um bucket do Amazon S3 em sua conta, contendo os arquivos e binários necessários para inicializar as aplicações que os usuários utilizarão. Os blocos de aplicações também incluem o script de configuração que informa ao sistema operacional como lidar com o arquivo VHD.
Os blocos de aplicações oferecem suporte a dois tipos diferentes de empacotamento:
+ Custom: escolha essa opção para criar seu pacote de aplicações (VHD) manualmente. Para obter mais informações, consulte [Blocos de aplicações personalizados](custom-app-blocks.md).
+ WorkSpaces Aplicativos - Escolha essa opção recomendada para criar seu pacote de aplicativos usando o construtor de blocos de aplicativos. Para obter mais informações, consulte [WorkSpaces Aplicativos: Blocos de aplicativos](appstream-app-blocks.md).
**Topics**
+ [Blocos de aplicações personalizados](custom-app-blocks.md)
+ [WorkSpaces Aplicativos: Blocos de aplicativos](appstream-app-blocks.md)
+ [Aplicações incompatíveis](app-blocks-unsupported.md)
# 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.
# WorkSpaces Aplicativos: Blocos de aplicativos
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. No que se refere a blocos de aplicações com empacotamento personalizado, você tem a flexibilidade de criar um arquivo VHD próprio e carregá-lo em um bucket do Amazon S3 em sua conta. Como alternativa, para blocos de WorkSpaces aplicativos com empacotamento de aplicativos, você pode aproveitar o construtor de blocos de aplicativos, que gerencia o empacotamento de seus aplicativos, cria um arquivo VHD e o carrega em seu bucket do Amazon S3.
Ao usar o bloco de WorkSpaces aplicativos empacotado de aplicativos, você não apenas elimina a necessidade de etapas manuais na criação de um arquivo VHD, mas também remove a necessidade de um script de configuração. Ele expande a compatibilidade de aplicativos com frotas elásticas, além de reduzir as etapas administrativas manuais necessárias para criar um bloco de aplicativos. WorkSpaces Os aplicativos gerenciam a configuração de blocos de WorkSpaces aplicativos com o empacotamento de aplicativos automaticamente, sem a necessidade de nenhum script de configuração. No entanto, você ainda pode fornecer scripts opcionais de pós-configuração para personalizar a instalação de acordo com suas necessidades.
**Topics**
+ [Visão geral do](appstream-app-blocks-overview.md)
+ [Aplicações incompatíveis](appstream-app-blocks-unsupported.md)
+ [Criar um bloco de WorkSpaces aplicativos](appstream-app-blocks-create.md)
+ [Ativar um bloco de aplicações](appstream-app-blocks-activate.md)
+ [Criar um bloco de aplicações com um pacote de aplicações existente](appstream-app-blocks-create-VHD.md)
+ [Testar um bloco de aplicações](appstream-app-blocks-test.md)
+ [Associar um bloco de aplicativos aos WorkSpaces aplicativos da Amazon](appstream-app-blocks-associate.md)
+ [Desassociar um bloco de aplicativos nos aplicativos da Amazon WorkSpaces](appstream-app-blocks-disassociate.md)
# Visão geral do
Para criar um bloco de WorkSpaces aplicativos com o pacote de aplicativos, você precisa iniciar uma sessão de streaming com um criador de blocos de aplicativos. Depois que a sessão for inicializada, você poderá fazer download dos instaladores de aplicações e habilitar as opções de gravação. A partir desse ponto, os WorkSpaces aplicativos registram as alterações no sistema de arquivos e no registro feitas no criador de blocos de aplicativos usando a tecnologia de redirecionamento de aplicativos.
O redirecionamento de aplicações usa o framework do driver de filtros do Windows para interceptar e redirecionar alterações no sistema de arquivos e no registro. Esse redirecionamento é integrado para a aplicação que está sendo instalada. A aplicação continuará interagindo com os locais originais dos arquivos na unidade C:. Por exemplo, se um instalador para "TestApplication" for executado em uma máquina com o Redirecionamento de Aplicativos configurado, ele será instalado por padrão em C:\$1Program Files\$1TestApplication. No entanto, nos bastidores, todos os arquivos e pastas serão redirecionados para um disco rígido virtual (VHD) montado e será criado um link do local original do arquivo para o local real do arquivo. Na máquina, ainda TestApplication parecerá estar instalado em C:\$1Program Files\$1TestApplication.
Depois que todas as alterações de instalação forem registradas, o arquivo VHD será carregado em um bucket do Amazon S3 em sua conta.
Quando um usuário solicita uma sessão usando uma frota da Elastic, o WorkSpaces Applications baixa o arquivo VHD, configura o aplicativo, executa os scripts de configuração pós-instalação (opcional) e inicia o streaming do aplicativo.
**nota**
A tecnologia de redirecionamento de aplicações não registra nenhuma alteração no sistema de arquivos em %USERPROFILE%, exceto novos diretórios criados nos diretórios %APPDATA% e %LOCALAPPDATA%.
A tecnologia de redirecionamento de aplicações não registra nenhuma alteração no registro do usuário atual, HKEY\$1CURRENT\$1USER (HKCU).
# Aplicações incompatíveis
As aplicações podem encontrar falhas durante a instalação ou execução nos seguintes cenários:
+ **Aplicações com verificações baseadas em local durante a instalação**: se o processo de instalação de uma aplicação verificar a localização real dos arquivos instalados, isso poderá resultar em uma falha. Como os WorkSpaces aplicativos redirecionam os arquivos para o bloco de aplicativos VHD, somente os links para os arquivos reais são mantidos no local original.
Se você não tiver certeza se seu aplicativo se enquadra em alguma dessas categorias, você pode usar o pacote de WorkSpaces aplicativos para criar um bloco de aplicativos. Esse processo envolve a instalação das aplicações em uma instância do construtor de blocos de aplicações. Em caso de falha na instalação das aplicações na instância do construtor de blocos de aplicações, você pode realizar as seguintes ações:
+ Verifique os logs. O arquivo de registro de erros da sua instância do App Block Builder pode ser encontrado em C:\$1\$1 AppStreamAppBlocks\$1 ErrorLog. Esse registro registra todas as falhas de instalação, incluindo o processamento RegKeys/File da operação. Se você ver algum dos registros a seguir no ErrorLog, isso indica que o empacotamento do seu aplicativo atualmente não é suportado pelo construtor de blocos de WorkSpaces aplicativos:
+ “Não foi possível criar link simbólico”
+ “O serviço não oferece suporte à renomeação de arquivos”
Se não houver nenhum arquivo errorLog ou se esse arquivo estiver vazio, verifique os logs de instalação da aplicação para identificar o motivo das falhas.
+ Relate um problema. Selecione o botão **Relatar um problema**, que está disponível no assistente do construtor de aplicações no construtor de blocos de aplicações. Selecionar essa opção reunirá todos os registros de WorkSpaces aplicativos da sua instância do construtor de blocos de aplicativos e os enviará à equipe de WorkSpaces aplicativos para obter assistência.
+ Crie um bloco de aplicações com empacotamento personalizado: se você não conseguir empacotar suas aplicações usando o construtor de blocos de aplicações, tente criar um bloco de aplicações usando métodos de empacotamento personalizados. Para obter mais informações, consulte [Blocos de aplicações personalizados](custom-app-blocks.md).
+ Se precisar de ajuda adicional, entre em contato com o AWS Support. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).
É importante considerar essas possíveis limitações e planejar adequadamente ao usar o pacote de WorkSpaces aplicativos para seus aplicativos.
# Criar um bloco de WorkSpaces aplicativos
Siga estas etapas para criar um bloco de aplicativos com o tipo de embalagem WorkSpaces Applications.
## Etapa 1: Configurar um bloco de aplicações
**Como configurar um 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 **Gerenciador de aplicações**, **Blocos de aplicações** e **Criar bloco de aplicações**.
1. Para o empacotamento de blocos de aplicativos, selecione **WorkSpaces Aplicativos**.
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**: um nome exclusivo para o bloco de aplicações.
+ **Nome de exibição** (opcional): um nome intuitivo para o bloco de aplicações.
+ **Descrição** (opcional): uma descrição para o bloco de aplicações.
1. (Opcional) Um bloco de WorkSpaces aplicativos com pacote de aplicativos não precisa de um script de configuração. Opcionalmente, você pode fornecer as seguintes **Opções avançadas** para as etapas pós-instalação:
+ Em **Objeto de script pós-configuração no S3**, insira o URI do Amazon S3 que representa o objeto do script pós-configuração ou escolha **Procurar no S3** para navegar até seus buckets do Amazon S3 e encontrar o objeto do script de configuração.
+ Em **Executável do script pós-configuração**, insira o executável necessário para seu script pós-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`
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) .
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. Em **Configurações de importação**, escolha **Criar arquivo de aplicação de bloco de aplicações**. Para **Local do S3** em **Configurações de importação**, insira o URI do Amazon S3 que representa o bucket ou escolha **Procurar no S3** para navegar até seus buckets do Amazon S3 e selecionar um bucket apropriado. A lista de buckets do Amazon S3 é global e lista todos os buckets em todas as regiões. Selecione o bucket na região em que você deseja criar o bloco de aplicações. Para obter mais informações sobre como definir permissões de bucket, 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).
1. Selecione um construtor de blocos de aplicações. Somente construtores de blocos de aplicações que não estão associados a outros blocos de aplicações estão disponíveis. Se a lista estiver vazia, crie um construtor de blocos de aplicações ou desassocie os existentes para usar. Um construtor de blocos de aplicações é um recurso reutilizável que você pode usar para criar um pacote de aplicações.
**nota**
Se você não selecionar um construtor de blocos de aplicações aqui, ainda poderá criar seu bloco de aplicações no estado **Inativo** e ativá-lo posteriormente. Para obter mais informações, consulte [Ativar um bloco de aplicações](appstream-app-blocks-activate.md).
1. (Opcional) Em **Etiquetas**, crie etiquetas para o recurso do bloco de aplicações.
1. Escolha **Próximo**.
1. Revise as informações inseridas e escolha uma das seguintes opções:
+ Escolha **Criar bloco de aplicações** se você não selecionou um construtor de blocos de aplicações na etapa 7.
+ Escolha **Inicializar construtor de blocos de aplicações** se você escolheu um construtor de blocos de aplicações na etapa 7. Depois, continue na etapa 2 para criar o pacote de aplicações usando a sessão de streaming do construtor de blocos de aplicações.
Nesse momento, seu recurso de bloco de aplicações já foi criado, mas está **Inativo** e não pode ser usado para frotas elásticas.
## Etapa 2: Criar um pacote de aplicações
Use a instância de streaming do construtor de blocos de aplicações para empacotar suas aplicações e ativar seu bloco de aplicações. O bloco de aplicativo criado usando o App Block Builder terá um pacote de WorkSpaces aplicativos, e o pacote do aplicativo será carregado no bucket do Amazon S3 em seu. Conta da AWS
**Como criar um pacote de aplicações**
1. Depois que sua sessão de streaming estiver ativada, o assistente do construtor de aplicações será iniciado automaticamente. Se não iniciar, inicie-o manualmente usando o ícone da área de trabalho.
1. A tela inicial fornece instruções para o processo de empacotamento de aplicações.
1. Inclua o instalador de aplicações na sessão de streaming do construtor de blocos de aplicações usando uma das seguintes opções:
+ Baixe os instaladores de aplicações da web.
+ Use a interface de arquivo da sessão de streaming.
+ Baixe o instalador de aplicações de outro serviço da AWS usando um perfil de máquina.
1. Depois de ter todos os instaladores de aplicações necessários, interrompa todas as outras aplicações em execução na instância e escolha **Iniciar gravação**. O construtor de blocos de aplicações começa a registrar as alterações do sistema e a tela diz **Gravação em andamento**.
1. Comece a instalar suas aplicações uma por uma.
1. Quando terminar de instalar as aplicações, escolha **Parar gravação** e o sistema interromperá o registro das alterações. Se você quiser fazer mais alterações no pacote de aplicações, como adicionar mais aplicações ou remover uma aplicação já instalada, escolha **Iniciar gravação** e verifique se o sistema está no modo **Gravação em andamento**.
**nota**
Se a instalação do aplicativo falhar, escolha **Relatar um problema** para coletar registros relacionados a WorkSpaces aplicativos da instância e relatar o problema à equipe de WorkSpaces aplicativos. Quando terminar, encerre a sessão de streaming do construtor de blocos de aplicações. Você pode tentar reiniciar o processo de criação de um bloco de aplicações usando uma nova instância do construtor de blocos de aplicações. Se o problema persistir, tente criar o bloco de aplicações usando um empacotamento personalizado.
1. Quando terminar de instalar todas as aplicações, escolha **Parar gravação**. Você pode testar sua aplicação usando o menu Iniciar ou procurando a aplicação usando o Explorador de Arquivos.
1. Escolha **Próximo** para revisar os detalhes do bloco de aplicações.
**nota**
O tamanho recomendado de um arquivo de pacote de aplicações (VHD) para uma frota elástica é até 1,5 GB. Se o tamanho do seu arquivo VHD for maior que 1,5 GB, tente reduzir o número de aplicações empacotadas no bloco de aplicações.
O tamanho do arquivo do pacote de aplicações (VHD) não diminuirá se você desinstalar uma aplicação. Reinicie o processo de empacotamento de aplicações usando uma nova sessão de streaming do bloco de aplicações e instale menos aplicações.
1. Escolha **Concluir criação do bloco de aplicações e desconectar** para criar o pacote de aplicações e carregá-lo no bucket do Amazon S3. Se tudo correr bem, a sessão de streaming será desconectada automaticamente e o bloco de aplicações ficará em um estado **Ativo**.
**nota**
Se a instalação do aplicativo falhar, escolha **Relatar um problema** para coletar registros relacionados a WorkSpaces aplicativos da instância e relatar o problema à equipe de WorkSpaces aplicativos. Quando terminar, encerre a sessão de streaming do construtor de blocos de aplicações. Você pode tentar reiniciar o processo de criação de um bloco de aplicações usando uma nova instância do construtor de blocos de aplicações. Se o problema persistir, tente criar o bloco de aplicações usando um empacotamento personalizado.
# Ativar um bloco de aplicações
Se um bloco de WorkSpaces aplicativos com pacote de aplicativos foi criado, mas o pacote de aplicativos (VHD) não foi anexado a ele, o bloco de aplicativos ficará em um estado inativo e não poderá ser usado para associar aplicativos a frotas da Elastic. Para ativar um bloco de aplicações, um pacote de aplicações (VHD) deve ser associado ao bloco de aplicações.
**Como criar um pacote 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 **Gerenciador de aplicações**, **Blocos de aplicações**.
1. Selecione um bloco de aplicações **Inativo** que você deseja ativar e escolha **Ativar** no menu **Ações**.
1. Selecione um construtor de blocos de aplicações e escolha **Inicializar construtor de blocos de aplicações**.
+ Uma lista vazia significa que você não tem um construtor de blocos de aplicações ou que todos os seus construtores de blocos de aplicações estão associados a outros blocos de aplicações. Crie um construtor de blocos de aplicações ou desassocie um construtor de blocos de aplicações existente e teste-o.
+ Se o construtor de blocos de aplicações já estiver associado a um bloco de aplicações, você poderá continuar usando ele para ativar o bloco de aplicações.
+ Se o construtor de blocos de aplicações selecionado não estiver associado a um blocos de aplicações, ele será associado ao que você selecionou e a sessão de streaming será inicializada. O construtor de blocos de aplicações permanecerá associado a esse bloco de aplicações após o término da sessão.
1. Depois que a sessão de streaming do construtor de blocos de aplicações começar, siga as etapas em [Etapa 2: Criar um pacote de aplicações](appstream-app-blocks-create.md#appstream-app-blocks-create-step2) para criar o pacote de aplicações (VHD) e ativar o bloco de aplicações.
# Criar um bloco de aplicações com um pacote de aplicações existente
Você pode usar seu pacote de aplicativos (VHD) existente com o pacote de WorkSpaces aplicativos para criar blocos de WorkSpaces aplicativos de aplicativos. Para fazer isso, copie o arquivo do pacote de aplicações (VHD) do bucket do Amazon S3 de origem para outro bucket do Amazon S3 de destino. O bucket de destino pode estar em uma região diferente.
**Como criar um bloco de aplicações com um pacote de aplicações existente**
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 **Gerenciador de aplicações**, **Blocos de aplicações** e **Criar bloco de aplicações**.
1. Para o empacotamento de blocos de aplicativos, selecione **WorkSpaces Aplicativos**.
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**: um nome exclusivo para o bloco de aplicações.
+ **Nome de exibição** (opcional): um nome intuitivo para o bloco de aplicações.
+ **Descrição** (opcional): uma descrição para o bloco de aplicações.
1. (Opcional) Um bloco de WorkSpaces aplicativos com pacote de aplicativos não precisa de um script de configuração. Opcionalmente, você pode fornecer as seguintes **Opções avançadas** para as etapas pós-instalação:
+ Em **Objeto de script pós-configuração no S3**, insira o URI do Amazon S3 que representa o objeto do script pós-configuração ou escolha **Procurar no S3** para navegar até seus buckets do Amazon S3 e encontrar o objeto do script de configuração.
+ Em **Executável do script pós-configuração**, insira o executável necessário para seu script pós-configuração.
**nota**
Se o script pós-configuração puder ser executado diretamente, insira o nome do arquivo do script pós-configuração. Se o script de pós-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`
Opcionalmente, em **Argumentos do executável do script de pós-configuração**, 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 pós-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) .
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 pós-configuração antes de continuar. Se o script pós-configuração da postagem não for concluído dentro desse período, um erro será exibido para o usuário e o aplicação tentará ser inicializado. O script de configuração é encerrado após o término da duração da execução.
1. Escolha **Usar arquivo de aplicação de bloco de aplicações existente** em **Configurações de importação**. Em **Local do S3**, você pode inserir o URI do Amazon S3 para o objeto em um bucket do Amazon S3 que representa o pacote do aplicações (VHD). Como alternativa, também pode escolher **Procurar no S3** para navegar até seus buckets do Amazon S3 e selecionar o objeto em um bucket do Amazon S3. A lista de buckets do Amazon S3 é global e lista todos os buckets em todas as regiões. Selecione o bucket na região em que você deseja criar o bloco de aplicações.
1. Escolha **Próximo**.
1. Revise as informações inseridas e escolha **Criar bloco de aplicações**.
A essa altura, seu recurso de bloco de aplicações já foi criado e está no estado **Ativo**.
# Testar um bloco de aplicações
Você pode usar um construtor de blocos de aplicações para testar seu bloco de aplicações e verificar as funcionalidades da sua aplicação. Não é necessário inicializar uma frota elástica para essa opção. Você também pode criar vários construtores de blocos de aplicações com diferentes tipos ou tamanhos de instância e testar a performance da sua aplicação com diferentes opções de computação.
**nota**
A opção de bloqueio de aplicativos de teste é compatível somente com blocos de WorkSpaces aplicativos com pacote de aplicativos.
**Como testar um 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 **Gerenciador de aplicações**, **Blocos de aplicações**.
1. Selecione um bloco de aplicações que você deseja testar e escolha **Testar** no menu **Ações**.
1. Selecione um construtor de blocos de aplicações e escolha **Inicializar e testar bloco de aplicações**.
+ Uma lista vazia significa que você não tem um construtor de blocos de aplicações ou que todos os seus construtores de blocos de aplicações estão associados a outros blocos de aplicações. Crie um construtor de blocos de aplicações ou desassocie um construtor de blocos de aplicações existente e teste-o.
+ Se o construtor de blocos de aplicações já estiver associado a um bloco de aplicações, você poderá continuar usando ele para ativar o bloco de aplicações.
+ Se o construtor de blocos de aplicações selecionado não estiver associado a um blocos de aplicações, ele será associado ao que você selecionou e a sessão de streaming será inicializada. O construtor de blocos de aplicações permanecerá associado a esse bloco de aplicações após o término da sessão.
1. O construtor de blocos de aplicações é inicializado em uma janela separada do navegador no modo de streaming Área de trabalho. O serviço faz download do bloco de aplicações do bucket do Amazon S3 e o instala na instância do construtor de blocos de aplicações.
1. Você já pode fazer streaming e testar suas aplicações. Para abrir sua aplicação, procure-a no Explorador de Arquivos ou use o menu Iniciar.
1. Quando terminar de testar, encerre a sessão de streaming.
# Associar um bloco de aplicativos aos WorkSpaces aplicativos da Amazon
Para criar, testar ou ativar seu bloco de WorkSpaces aplicativos com o pacote de aplicativos, você precisa associá-lo a um criador de blocos de aplicativos. Um construtor de blocos de aplicações só pode ser associado a um único bloco de aplicações e vice-versa.
**nota**
A associação e desassociação de um bloco de aplicativos só é suportada para blocos de aplicativos com WorkSpaces pacote de aplicativos.
**Associe um bloco de aplicativo ao construtor de blocos de aplicativos na Amazon WorkSpaces Applications**
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 **Gerenciador de aplicações**, **Blocos de aplicações**.
1. Selecione um bloco de aplicações e escolha **Associar** no menu **Ações**.
1. Selecione um construtor de blocos de aplicações e escolha **Associar construtor de blocos de aplicações**.
Uma lista vazia significa que você não tem um construtor de blocos de aplicações ou que todos os seus construtores de blocos de aplicações estão associados a outros blocos de aplicações. Crie um construtor de blocos de aplicações ou desassocie um construtor de blocos de aplicações existente e associe-o.
# Desassociar um bloco de aplicativos nos aplicativos da Amazon WorkSpaces
Se todos os seus construtores de blocos de aplicações estiverem associados a outros blocos de aplicações e você quiser testar, criar ou ativar outro bloco de aplicações, poderá criar um construtor de blocos de aplicações ou desassociar um construtor de blocos de aplicações existente do bloco de aplicações e usá-lo com o novo bloco de aplicações.
**nota**
A associação e desassociação de um bloco de aplicativos só é suportada para blocos de aplicativos com WorkSpaces pacote de aplicativos.
A desassociação só é permitida se o construtor de blocos de aplicações estiver no estado **PARADO**.
**Desassociar um bloco de aplicações de um construtor de blocos 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 **Gerenciador de aplicações**, **Blocos de aplicações**.
1. Selecione um bloco de aplicações e escolha **Desassociar** no menu **Ações**.
1. Selecione um construtor de blocos de aplicações já associado e escolha **Desassociar construtor de blocos de aplicações**.
# Aplicações incompatíveis
As aplicações podem encontrar falhas durante a instalação ou execução nos seguintes cenários:
+ **Aplicações que exigem reinicialização após a instalação**: se uma aplicação precisar realizar alterações ou configurações adicionais após a instalação que exijam uma reinicialização, ela poderá falhar. No momento, o construtor de blocos de aplicações não oferece suporte à reinicialização, o que pode impedir que a aplicação conclua as etapas necessárias pós-instalação.
+ **Aplicativos que dependem de detalhes específicos do usuário**: aplicativos que devem ser instalados somente para o usuário atualmente conectado no construtor de blocos de aplicativos ou que dependem dos detalhes do usuário conectado no construtor de blocos de aplicativos, como identificadores de segurança (SIDs) durante a instalação, podem não funcionar corretamente nas frotas da Elastic. Isso se deve às alterações do usuário conectado no ambiente da frota elástica. Além disso, o redirecionamento de aplicações não registra todos os diretórios em %USERPROFILE%. No entanto, você tem a opção de configurar scripts pós-configuração para alterar dinamicamente a configuração da aplicação com base no ambiente.
+ **Aplicações que dependem de detalhes específicos da máquina**: as aplicações que dependem de detalhes específicos da máquina no construtor de blocos de aplicações durante a instalação, como o GUID do adaptador de rede, podem encontrar problemas em frotas elásticas. Isso ocorre porque os detalhes da máquina, incluindo o adaptador de rede GUIDs, podem mudar dentro do ambiente de frota elástica. Para resolver isso, você pode configurar os scripts pós-configuração para lidar com a configuração desses detalhes específicos da máquina.
Se você não tiver certeza se seu aplicativo se enquadra em alguma dessas categorias, você pode usar o pacote de WorkSpaces aplicativos para criar um bloco de aplicativos. Esse processo envolve a instalação das aplicações em uma instância do construtor de blocos de aplicações. Em caso de falha na instalação das aplicações na instância do construtor de blocos de aplicações, você pode realizar as seguintes ações:
+ Verifique os logs. O arquivo de registro de erros da sua instância do App Block Builder pode ser encontrado em C:\$1\$1 AppStreamAppBlocks\$1 ErrorLog. Esse log registra todas as falhas de instalação, incluindo o processamento da operação de arquivo e chaves de registro. Se você ver algum dos registros a seguir no ErrorLog, isso indica que o empacotamento do seu aplicativo atualmente não é suportado pelo construtor de blocos de WorkSpaces aplicativos:
+ “Não foi possível criar link simbólico”
+ “O serviço não oferece suporte à renomeação de arquivos”
Se não houver nenhum arquivo errorLog ou se esse arquivo estiver vazio, verifique os logs de instalação da aplicação para identificar o motivo das falhas.
+ Relate um problema. Selecione o botão **Relatar um problema**, que está disponível no assistente do construtor de aplicações no construtor de blocos de aplicações. Selecionar essa opção reunirá todos os registros de WorkSpaces aplicativos da sua instância do construtor de blocos de aplicativos e os enviará para a equipe de WorkSpaces aplicativos.
+ Crie um bloco de aplicações com empacotamento personalizado: se você não conseguir empacotar suas aplicações usando o construtor de blocos de aplicações, tente criar um bloco de aplicações usando métodos de empacotamento personalizados. Para obter mais informações, consulte [Blocos de aplicações personalizados](custom-app-blocks.md).
+ Se precisar de ajuda adicional, entre em contato com o AWS Support. Para obter mais informações, consulte o [AWS Support Center](https://console.aws.amazon.com/support/home#/).
É importante considerar essas possíveis limitações e planejar adequadamente ao usar o pacote de WorkSpaces aplicativos para seus aplicativos.