Habilite e administre pastas pessoais para seus usuários AppStream 2.0 - Amazon AppStream 2.0
Arquivos e diretórios associados a aplicações de computação intensivaHabilite pastas pessoais para seus usuários AppStream 2.0Administrar as pastas base

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

Habilite e administre pastas pessoais para seus usuários AppStream 2.0

AppStream 2.0 oferece suporte às seguintes opções de armazenamento persistente para usuários em sua organização:

  • Pastas base

  • Google Drive para Google Workspace

  • OneDrive para negócios

Você pode habilitar uma ou mais opções para a sua organização. Quando você ativa as pastas iniciais para uma pilha AppStream 2.0, os usuários da pilha podem acessar uma pasta de armazenamento persistente durante as sessões de streaming do aplicativo. Não é necessária nenhuma configuração adicional para que os usuários acessem a pasta base. Os dados armazenados por usuários na pasta base são copiados automaticamente para backup em um bucket do Amazon Simple Storage Service na sua conta da Amazon Web Services e são disponibilizados para esses usuários em sessões subsequentes.

Os arquivos e as pastas são criptografados em trânsito usando endpoints SSL do Amazon S3. Os arquivos e as pastas são criptografados em repouso usando chaves de criptografia gerenciadas pelo Amazon S3.

As pastas base são armazenados nas instâncias de frota nos seguintes locais padrão:

  • Para uma única sessão, instâncias non-domain-joined do Windows: C:\Users\PhotonUser\ My Files\ Home Folder

  • Para várias sessões, instâncias non-domain-joined do Windows: C:\Users\as2 -xxxxxxxx\ My Files\ Home Folder, em que as2-xxxxxxxxx é um nome de usuário aleatório atribuído a cada sessão de usuário. Você pode determinar seu nome de usuário local por meio da variável de ambiente $USERNAME.

  • Instâncias do Windows associadas a um domínio: C:\Users\%username%\My Files\Home Folder

  • Instâncias Linux: ~//MyFilesHomeFolder

Como administrador, use o caminho aplicável se você configurar suas aplicações para salvar na pasta base. Em alguns casos, os usuários podem não conseguir encontrar as pastas base, pois alguns aplicativos não reconhecem o redirecionamento que exibe a pasta base como uma pasta de nível superior no Explorador de Arquivos. Se esse for o caso, os usuários podem acessar suas pastas base navegando até o mesmo diretório no Explorador de arquivos.

Arquivos e diretórios associados a aplicações de computação intensiva

Durante as sessões de streaming AppStream 2.0, salvar arquivos e diretórios grandes associados a aplicativos de computação intensiva no armazenamento persistente pode levar mais tempo do que salvar arquivos e diretórios necessários para aplicativos básicos de produtividade. Por exemplo, pode levar mais tempo para que as aplicações salvem uma grande quantidade de dados ou modifiquem os mesmos arquivos com frequência do que para salvar arquivos criados por aplicações que executam uma única ação de gravação. Também pode levar mais tempo para salvar muitos arquivos pequenos.

Se seus usuários salvam arquivos e diretórios associados a aplicativos de computação intensiva e as opções de armazenamento persistente AppStream 2.0 não estão funcionando conforme o esperado, recomendamos que você use uma solução Server Message Block (SMB), como Amazon FSx for Windows File Server ou um gateway de arquivos. AWS Storage Gateway Veja a seguir exemplos de arquivos e diretórios associados a aplicações de computação intensiva que são mais adequados para uso com essas soluções de SMB:

  • Pastas de espaço de trabalho para ambientes de desenvolvimento integrado (IDEs)

  • Arquivos de bancos de dados locais

  • Pastas de espaço de rascunho criadas por aplicações de simulação gráfica

Para obter mais informações, consulte:

Habilite pastas pessoais para seus usuários AppStream 2.0

Antes de habilitar as pastas base, é necessário fazer o seguinte:

Você pode ativar ou desativar as pastas pessoais ao criar uma pilha (consulteCriar um stack) ou depois que a pilha for criada usando o AWS Management Console for AppStream 2.0, AWS SDK ou. AWS CLI Para cada AWS região, as pastas iniciais são copiadas por um bucket do Amazon S3.

Na primeira vez que você habilita pastas pessoais para uma pilha AppStream 2.0 em uma AWS região, o serviço cria um bucket Amazon S3 em sua conta na mesma região. O mesmo bucket é usado para armazenar o conteúdo das pastas base para todos os usuários e todas as pilhas dessa região. Para ter mais informações, consulte Armazenamento em bucket do Amazon S3.

nota

Para obter orientações que você pode fornecer aos usuários para ajudá-los a começar a usar as pastas pessoais durante as sessões de streaming AppStream 2.0, consulteUsar pastas base.

Para habilitar as pastas base ao criar uma pilha

  • Siga as etapas em Criar um stack e verifique se a opção Enable Home Folders (Habilitar pastas base) está selecionada.

Para habilitar as pastas base de uma pilha existente

  1. Abra o console AppStream 2.0 em https://console.aws.amazon.com/appstream2.

  2. No painel de navegação à esquerda, selecione Stacks (Pilhas) e selecione a pilha para a qual as pastas base serão habilitadas.

  3. Abaixo da lista de pilhas, escolha Storage (Armazenamento) e marque Enable Home Folders (Habilitar pastas base).

  4. Na caixa de diálogo Enable Home Folders (Habilitar pastas base), selecione Enable (Habilitar).

Administrar as pastas base

Desabilitar pastas base

Você pode desabilitar as pastas base de uma pilha sem perder o conteúdo de usuários já armazenado nelas. Desabilitar as pastas base de uma pilha tem os seguintes efeitos:

  • Os usuários que estão conectados a sessões de streaming ativas para a pilha recebem uma mensagem de erro. Eles são informados de que não poderão mais armazenar conteúdo na pasta base.

  • As pastas base não serão exibidas para novas sessões que usam a pilha com pastas base desabilitadas.

  • Desabilitar as pastas base para uma pilha não as desabilita para outras pilhas.

  • Mesmo que as pastas pessoais estejam desativadas para todas as pilhas, a AppStream versão 2.0 não exclui o conteúdo do usuário.

Para restaurar o acesso às pastas base da pilha, habilite as pastas base novamente seguindo as etapas descritas no tópico anterior.

Para desabilitar as pastas base ao criar uma pilha

  • Siga as etapas em Criar um stack e verifique se a opção Enable Home Folders (Habilitar pastas base) está desmarcada.

Para desabilitar as pastas base de uma pilha existente

  1. Abra o console AppStream 2.0 em https://console.aws.amazon.com/appstream2.

  2. No painel de navegação à esquerda, selecione Stacks (Pilhas) e selecione a pilha.

  3. Abaixo da lista de pilhas, escolha Storage (Armazenamento) e desmarque Enable Home Folders (Habilitar pastas base).

  4. Na caixa de diálogo Disable Home Folders (Desabilitar pastas base), digite CONFIRM (diferencia maiúsculas de minúsculas) para confirmar sua escolha e, em seguida, selecione Disable (Desabilitar).

Armazenamento em bucket do Amazon S3

AppStream 2.0 gerencia o conteúdo do usuário armazenado nas pastas iniciais usando buckets do Amazon S3 criados em sua conta. Para cada AWS região, AppStream 2.0 cria um bucket na sua conta. Todo o conteúdo dos usuários gerado de sessões de streaming de pilhas naquela região é armazenado nesse bucket. Os buckets são totalmente gerenciados pelo serviço, sem nenhuma entrada ou configuração de um administrador. Os buckets são nomeados em um formato específico da seguinte forma: 

appstream2-36fb080bb8-region-code-account-id-without-hyphens

Onde region-code está o código AWS da região na qual a pilha é criada e account-id-without-hyphens o ID da sua conta da Amazon Web Services. A primeira parte do nome do bucket, appstream2-36fb080bb8-, não é alterada entre contas ou regiões.

Por exemplo, se você habilitar as pastas base para pilhas na região Oeste dos EUA (Oregon) (us-west-2) no número de conta 123456789012, o serviço criará um bucket do Amazon S3 nessa região com o nome exibido. Somente um administrador com permissões suficientes pode excluir esse bucket.

appstream2-36fb080bb8-us-west-2-123456789012

Conforme mencionado anteriormente, desabilitar as pastas base para pilhas não exclui nenhum conteúdo dos usuários armazenado no bucket do Amazon S3. Para excluir permanentemente o conteúdo do usuário, um administrador com acesso adequado deve fazer isso no console do Amazon S3. AppStream 2.0 adiciona uma política de bucket que evita a exclusão acidental do bucket. Para ter mais informações, consulte Usando IAM políticas para gerenciar o acesso do administrador ao bucket do Amazon S3 para persistência de pastas iniciais e configurações de aplicativos.

Sincronização do conteúdo da pasta base

Quando as pastas pessoais estão habilitadas, a AppStream versão 2.0 cria uma pasta exclusiva para cada usuário na qual armazenar seu conteúdo. A pasta é criada como um prefixo exclusivo do Amazon S3 que usa um hash do nome de usuário em um bucket do S3 para sua conta e região da Amazon Web Services. Depois que a AppStream versão 2.0 cria a pasta inicial no Amazon S3, ela copia o conteúdo acessado nessa pasta do bucket do S3 para a instância da frota. Isso permite que o usuário acesse rapidamente o conteúdo da pasta base, pela instância da frota, durante a sessão de streaming. As alterações que você faz no conteúdo da pasta inicial de um usuário em um bucket do S3 e que o usuário faz no conteúdo da pasta inicial em uma instância de frota são sincronizadas entre o Amazon S3 AppStream e 2.0 da seguinte forma.

  1. No início da sessão de streaming AppStream 2.0 de um usuário, AppStream 2.0 cataloga os arquivos da pasta inicial que são armazenados para esse usuário no bucket do Amazon S3 para sua conta e região da Amazon Web Services.

  2. O conteúdo da pasta inicial do usuário também é armazenado na instância de frota AppStream 2.0 da qual ele transmite. Quando um usuário acessa sua pasta pessoal na instância de frota AppStream 2.0, a lista de arquivos catalogados é exibida.

  3. AppStream 2.0 baixa um arquivo do bucket do S3 para a instância da frota somente depois que o usuário usa um aplicativo de streaming para abrir o arquivo durante a sessão de streaming.

  4. Depois que o AppStream 2.0 baixa o arquivo para a instância da frota, a sincronização ocorre depois que o arquivo é acessado

  5. Se o usuário alterar o arquivo durante a sessão de streaming, o AppStream 2.0 carregará a nova versão do arquivo da instância da frota para o bucket do S3 periodicamente ou no final da sessão de streaming. No entanto, o arquivo não será baixado do bucket do S3 novamente durante a sessão de streaming.

As seções a seguir descrevem o comportamento de sincronização quando você adiciona, substitui ou remove o arquivo da pasta base de um usuário no Amazon S3.

Sincronização de arquivos adicionados à pasta base de um usuário no Amazon S3

Se você adicionar um novo arquivo à pasta inicial de um usuário em um bucket do S3, AppStream 2.0 cataloga o arquivo e o exibe na lista de arquivos na pasta pessoal do usuário em alguns minutos. No entanto, o arquivo não será baixado do bucket do S3 para a instância da frota até que o usuário abra o arquivo com uma aplicação durante a sessão de streaming.

Sincronização de arquivos substituídos na pasta base de um usuário no Amazon S3

Se um usuário abrir um arquivo em sua pasta base na instância da frota durante a sessão de streaming e você substituir o mesmo arquivo na pasta base em um bucket do S3 por uma nova versão durante a sessão de streaming ativa desse usuário, a nova versão do arquivo não será baixada imediatamente para a instância da frota. A nova versão só será baixada do bucket do S3 para a instância da frota depois que o usuário iniciar uma nova sessão de streaming e abrir o arquivo novamente.

Sincronização de arquivos removidos da pasta base de um usuário no Amazon S3

Se um usuário abrir um arquivo em sua pasta base na instância da frota durante a sessão de streaming e você remover o arquivo da pasta base em um bucket do S3 durante a sessão ativa de streaming desse usuário, o arquivo será removido da instância da frota depois que o usuário fizer uma das seguintes ações:

  • Abrir a pasta base novamente

  • Atualizar a pasta base

Formatos de pastas base

A hierarquia da pasta de um usuário depende de como esse usuário inicia uma sessão de streaming, conforme descrito nas seções a seguir.

AWS SDKs e AWS CLI

Para sessões ativadas usando CreateStreamingURL ou create-streaming-url, a estrutura da pasta do usuário é a seguinte:

bucket-name/user/custom/user-id-SHA-256-hash/

Onde bucket-name está no formato mostrado em Armazenamento em bucket do Amazon S3 e user-id-SHA-256-hash é o nome da pasta específica do usuário criado usando uma string hexadecimal de hash SHA-256 em minúsculas gerada a partir do UserId valor passado para a operação ou comando da API de URL. CreateStreaming create-streaming-url Para obter mais informações, consulte o CreateStreamingURL na Amazon AppStream 2.0 API Reference e create-streaming-urlna AWS CLI Command Reference.

O exemplo de estrutura de pastas a seguir se aplica ao acesso à sessão usando a API ou AWS CLI com um UserId testuser@mydomain.com, ID de conta 123456789012 na região Oeste dos EUA (Oregon) (us-west-2):

appstream2-36fb080bb8-us-west-2-123456789012/user/custom/a0bcb1da11f480d9b5b3e90f91243143eac04cfccfbdc777e740fab628a1cd13/

Você pode identificar a pasta de um usuário gerando o valor de hash SHA-256 de UserId em letras minúsculas usando sites ou bibliotecas de código fonte aberto disponíveis online.

SAML 2.0

Para sessões criadas usando a federação do SAML, a estrutura da pasta do usuário é a seguinte:

bucket-name/user/federated/user-id-SHA-256-hash/

Nesse caso, user-id-SHA-256-hash é o nome da pasta criada usando uma string hexadecimal hash SHA-256 em letras minúsculas gerada do valor do atributo do SAML NameID repassado na solicitação de federação do SAML. Para diferenciar os usuários que possuem o mesmo nome mas que pertencem a dois domínios diferentes, envie a solicitação do SAML com NameID no formato domainname\username. Para ter mais informações, consulte Integração da Amazon AppStream 2.0 com SAML 2.0.

A estrutura da pasta de exemplo a seguir aplica-se ao acesso de sessão usando a federação SAML com NameID SAMPLEDOMAIN\testuser, ID de conta 123456789012 na região Oeste dos EUA (Oregon):

appstream2-36fb080bb8-us-west-2-123456789012/user/federated/8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901

Quando parte ou toda a string nameID é capitalizada (como o nome de domínio SAMPLEDOMAIN está no exemplo) AppStream , 2.0 gera o valor de hash com base na capitalização usada na string. Usando esse exemplo, o valor de hash para SAMPLEDOMAIN\testuser é 8DD9A642F511609454D344D53CB861A71190E44FED2B8AF9FDE0C507012A9901. Na pasta desse usuário, esse valor é exibido em letas minúsculas, da seguinte forma: 8dd9a642f511609454d344d53cb861a71190e44fed2B8aF9fde0C507012a9901.

Você pode identificar a pasta de um usuário gerando o valor de hash SHA-256 de NameID usando sites ou bibliotecas de código fonte aberto disponíveis online.

Usando os AWS SDKs AWS Command Line Interface ou

Você pode ativar e desativar as pastas pessoais de uma pilha usando os AWS SDKs AWS CLI ou.

Use o comando create-stack a seguir para habilitar as pastas base ao criar uma pilha:

aws appstream create-stack --name ExampleStack --storage-connectors ConnectorType=HOMEFOLDERS

Use o comando update-stack para habilitar as pastas base de uma pilha existente:

aws appstream update-stack --name ExistingStack --storage-connectors ConnectorType=HOMEFOLDERS

Use o comando a seguir para desabilitar as pastas base de uma pilha existente. Esse comando não exclui nenhum dado do usuário.

aws appstream update-stack --name ExistingStack --delete-storage-connectors

Recursos adicionais

Para obter mais informações sobre como gerenciar buckets do Amazon S3 buckets e práticas recomendadas, consulte os tópicos a seguir no Guia do usuário do Amazon Simple Storage Service: