View a markdown version of this page

Criação e montagem automática do Amazon EFS no Studio - SageMaker IA da Amazon

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

Criação e montagem automática do Amazon EFS no Studio

O Amazon SageMaker AI oferece suporte à criação de um volume do Amazon EFS para um domínio e à montagem automática de uma pasta do diretório inicial para cada usuário. Ao usar esta pasta, os usuários podem compartilhar dados entre seus próprios espaços privados. No entanto, os usuários não podem compartilhar dados com outros usuários no domínio. Os usuários só têm acesso à sua própria pasta.

Importante

Para domínios criados após 1º de junho de 2026, o EFS não é criado por padrão durante a criação do domínio (para configuração rápida). Você deve habilitar a criação de EFS antes que a montagem automática possa ser habilitada.

Configurações de criação e montagem automática de EFS

O EFS no Amazon SageMaker Studio envolve duas configurações que funcionam juntas:

  • HomeEFSCreation— controla se um sistema de arquivos EFS é criado e gerenciado pela SageMaker IA para o domínio.

    Padrão para novos domínios criados por meio da configuração rápida: Desativado

    Quando ativado: cria um novo sistema de arquivos EFS gerenciado pela SageMaker AI para esse domínio.

  • AutoMountHomeEFS— Controla se o armazenamento EFS é montado automaticamente para os usuários.

    Padrão: Ativado (quando HomeEFSCreation está ativado)

    Descrição: Auto-mounts um diretório inicial para cada usuário compartilhar cadernos, dados e códigos em seus espaços privados.

    Essa configuração só é editável quando HomeEFSCreation está ativada.

    No nível do perfil do usuário, esse valor padrão é DefaultAsDomain(herda a configuração no nível do domínio).

Comportamentos principais:

  • Se nenhum valor for definido paraAutoMountHomeEFS, a montagem automática do EFS será ativada por padrão.

  • Se você tiver um espaço existente, reinicie o espaço para montar o EFS.

  • Auto-mount O EFS está disponível somente para espaços privados.

Habilitar a criação e montagem automática de EFS

Após a criação do domínio (configuração rápida):

  1. Abra o console de SageMaker IA.

  2. No painel de navegação esquerdo, em Configurações do administrador, escolha Domínios.

  3. Selecione seu domínio e, em seguida, escolha a guia Configurações do domínio.

  4. Na seção Configurações de armazenamento, escolha Editar.

  5. Em Armazenamento e criptografia do EFS, alterne HomeEFSCreation para ATIVADO. Isso cria um novo sistema de arquivos EFS gerenciado pela SageMaker IA para esse domínio.

  6. Verifique AutoMountHomeEFS se está ativado (ativado por padrão quando HomeEFSCreation está ativado). Isso monta automaticamente um diretório inicial para cada usuário compartilhar cadernos, dados e códigos em seus espaços privados.

  7. Selecione Enviar.

  8. Se você tiver espaços existentes, reinicie-os para acessar os dados do EFS.

Para configuração personalizada, a criação e montagem automática de EFS estão habilitadas por padrão.

A pasta do usuário pode ser acessada por meio de uma pasta chamada user-default-efs. Essa pasta está presente no diretório $HOME da aplicação do Studio.

Para informações sobre como remover a montagem automática do Amazon EFS, consulte Desativar a montagem automática do Amazon EFS.

A montagem automática do Amazon EFS também facilita a migração de dados do Studio Classic para o Studio. Para obter mais informações, consulte (Opcional) Migrar dados do Studio Classic para o Studio.

Informações do ponto de acesso

Quando a montagem automática é ativada, a SageMaker IA usa um ponto de acesso do Amazon EFS para facilitar o acesso aos dados no volume do Amazon EFS. Para obter mais informações sobre pontos de acesso, consulte Trabalhando com pontos de acesso do Amazon EFS A SageMaker IA cria um ponto de acesso exclusivo para cada perfil de usuário no domínio durante a criação do perfil do usuário ou durante a criação do aplicativo para um perfil de usuário existente. O valor de usuário POSIX do ponto de acesso corresponde ao HomeEfsFileSystemUid valor do perfil de usuário para o qual a SageMaker IA cria o ponto de acesso. Para obter o valor do usuário, consulte DescribeUserProfile. O caminho do diretório raiz também é definido com o mesmo valor que o valor do usuário POSIX. 

SageMaker A IA define as permissões do novo diretório com os seguintes valores:

  • ID de usuário do proprietário: POSIX user value

  • ID do grupo proprietário: 0

  • Permissões 700

O ponto de acesso é necessário para acessar o volume do Amazon EFS. Como resultado, você não pode excluir ou atualizar o ponto de acesso sem perder o acesso ao volume do Amazon EFS.

Resolução de erros

Se a SageMaker IA encontrar um problema ao montar automaticamente a pasta de usuário do Amazon EFS durante a criação do aplicativo, o aplicativo ainda será criado. No entanto, nesse caso, a SageMaker IA cria um arquivo chamado error.txt em vez de montar a pasta Amazon EFS. Esse arquivo descreve o erro encontrado, bem como as etapas para resolvê-lo. SageMaker O AI cria o error.txt arquivo na user-default-efs pasta localizada no $HOME diretório do aplicativo.