Criar o script de configuração para o VHD

AppStream 2.0 usa 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. AppStream 2.0 fornece 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 aplicativos com pacote AppStream 2.0. 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 Amazon Linux 2

• Script do Microsoft Windows Powershell

  nota

  AppStream 2.0 e o sistema operacional Microsoft Windows reservam as letras de unidade A a E. Não monte VHDs ou compartilhamentos de rede nessas letras de unidade.

AppStream 2.0 baixa o script de configuração e o VHD em um diretório na instância de streaming da frota e, em seguida, executa 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 contexto SYSTEM no Microsoft Windows e como usuário root no Amazon Linux 2.

Localização do sistema de arquivos para o VHD e o script de configuração:

• 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.

AppStream 2.0 mantém o nome do arquivo como ele está 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

AppStream 2.0 captura 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 AppStream , 2.0 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.

Execução do script de configuração do bloco de aplicações

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

AppStream 2.0 usa 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 ter mais informações, consulte Usando endpoints VPC do Amazon S3 para recursos 2.0 AppStream .

A persistência das configurações de aplicações está habilitada:

A persistência das configurações de aplicações está desabilitada: