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á. # Como adicionar um sistema de arquivos personalizado a um domínio Quando você cria um domínio, o Amazon SageMaker AI adiciona um volume padrão Amazon Elastic File System (Amazon EFS) ao domínio. SageMaker A IA cria esse volume para você. Você também tem a opção de adicionar um Amazon EFS personalizado ou um sistema de arquivos Amazon FSx for Lustre personalizado que você criou. Depois de adicioná-lo, seu sistema de arquivos ficará disponível para os usuários que pertencem ao seu domínio. Seus usuários podem acessar o sistema de arquivos quando usam o Amazon SageMaker Studio. Eles podem anexar o sistema de arquivos aos espaços que eles criam para os seguintes aplicações compatíveis: + JupyterLab + Editor de código Depois de executar um espaço e iniciar a aplicação, seus usuários podem acessar quaisquer dados, códigos ou outros artefatos que seu sistema de arquivos contenha. Você pode permitir que seus usuários acessem o sistema de arquivos das seguintes formas: + Por meio de *espaços compartilhados*: Um espaço compartilhado pode ser criado por qualquer usuário que pertença ao seu domínio. Em seguida, ele pode ser usado por qualquer usuário que pertença ao seu domínio. + Por meio de *espaços privados*: Um espaço privado pode ser criado por qualquer usuário que pertença ao seu domínio. Em seguida, ele pode ser usado somente por esse usuário. + Exclusivamente como usuário individual: se você não quiser permitir que todos os seus usuários acessem o sistema de arquivos, você pode permitir que somente um usuário específico o acesse. Se você fizer isso, o sistema de arquivos ficará disponível somente em espaços privados criados pelo usuário específico. Você pode adicionar um sistema de arquivos personalizado usando a SageMaker API da Amazon AWS SDKs, a ou AWS CLI a. Você não pode adicionar um sistema de arquivos personalizado usando o console de SageMaker IA. ## Pré-requisitos Antes de adicionar um sistema de arquivos personalizado a um domínio, você deve atender aos seguintes requisitos: + Você tem um domínio em SageMaker IA. Antes de adicionar um sistema de arquivos, você precisa do ID do domínio. Você pode pesquisar o ID usando o console de SageMaker IA. Você também pode executar o comando [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-domains.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/list-domains.html) com a AWS CLI. + Você tem um sistema de arquivos Amazon EFS ou FSx Lustre no seu Conta da AWS. ------ #### [ For Amazon EFS ] + Para ver as etapas para criar um, consulte [Create your Amazon EFS file system](https://docs.aws.amazon.com/efs/latest/ug/gs-step-two-create-efs-resources.html) no *Guia do usuário do Amazon Elastic File System*. + Para que o Studio possa acessar seu sistema de arquivos, ele deve ter um destino de montagem em cada uma das sub-redes associadas ao domínio. Para obter mais informações sobre a atribuição de destinos de montagem a sub-redes, consulte [Criação e gerenciamento de destinos de montagem e grupos de segurança](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) no *Guia do usuário do Amazon Elastic File System*. + Para cada destino de montagem, você deve adicionar o grupo de segurança que a Amazon SageMaker AI criou Conta da AWS quando você criou o domínio. O nome do grupo de segurança tem o formato `security-group-for-inbound-nfs-domain-id`. Para ver instruções sobre como obter suas configurações de domínio, consulte [Visualizar domínios](domain-view.md). + Suas permissões do IAM devem permitir que você use a ação `elasticfilesystem:DescribeMountTargets`. Para obter mais informações essa ação, consulte [Ações, recursos e chaves de condição do Amazon Elastic File System](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelasticfilesystem.html) na *Referência de autorização de serviço*. ------ #### [ For FSx for Lustre ] + Para ver as etapas para criar um FSx sistema de arquivos for Lustre, consulte [Introdução ao Amazon FSx for Lustre](https://docs.aws.amazon.com/fsx/latest/LustreGuide/getting-started.html.html) no Guia do usuário do *Amazon FSx for Lustre.* Certifique-se de que o sistema de arquivos FSx for Lustre exista em: + na mesma Amazon VPC do seu domínio; + em uma das sub-redes presentes em seu domínio. + Antes que o Studio possa acessar o sistema de arquivos FSx for Lustre, você deve adicionar o grupo de segurança do seu domínio a todas as interfaces de rede elástica (ENIs) em seu sistema de arquivos FSx for Lustre. Sem essa etapa, a criação da aplicação falhará e exibirá um erro. Use as instruções a seguir para adicionar o grupo de segurança de domínio ao seu sistema ENIs de arquivos FSx for Lustre. **Adicione seu grupo de segurança de domínio ao sistema FSx de arquivos Lustre ENIs (console)** 1. Navegue até o [ FSxconsole da Amazon](https://console.aws.amazon.com/fsx). 1. Escolha **Sistemas de arquivos**. 1. Escolha seu sistema de arquivos FSx para o Lustre usando o link correspondente em **ID do sistema de arquivos**. 1. Se ele ainda não estiver selecionado, escolha a guia **Rede e segurança**. 1. Em **Sub-rede**, escolha **Para ver todos as ENIs, veja o console do Amazon EC2**. Isso levará você ao console do Amazon EC2 e mostrará todos os arquivos ENIs vinculados ao seu sistema de arquivos FSx for Lustre. 1. Para cada ENI: 1. Escolha a ENI selecionando o link correspondente em **ID da interface de rede**. 1. Escolha **Ações** no canto superior direito da página de resumo para expandir um menu suspenso. 1. No menu suspenso, selecione **Escolher grupo de segurança**. 1. Pesquise o grupo de segurança do domínio. O nome do grupo de segurança tem o formato `security-group-for-inbound-nfs-domain-id`. Para ver instruções sobre como obter suas configurações de domínio, consulte [Visualizar domínios](domain-view.md). 1. Escolha **Adicionar grupo de segurança**. ------ ## Adicionar um sistema de arquivos personalizado a um domínio com o AWS CLI Para adicionar um sistema de arquivos personalizado a um domínio ou perfil de usuário com o AWS CLI, você passa uma `CustomFileSystemConfigs` definição ao usar qualquer um dos seguintes comandos: + [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-domain.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-domain.html) + [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-domain.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-domain.html) + [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-user-profile.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-user-profile.html) + [https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-user-profile.html](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/update-user-profile.html) Os exemplos a seguir mostram como adicionar um sistema de arquivos a um domínio ou perfil de usuário existente. **Para adicionar um sistema de arquivos que possa ser acessado em espaços compartilhados** + Atualize as configurações de espaço padrão do seu domínio. O seguinte exemplo adiciona as configurações do sistema de arquivos às configurações de espaço padrão: ``` aws sagemaker update-domain --domain-id domain-id \ --default-space-settings file://file-system-settings.json ``` O exemplo passa a configuração do sistema de arquivos como um arquivo JSON, que é mostrado em um exemplo posterior. **Para adicionar um sistema de arquivos que possa ser acessado em espaços privados** + Atualize as configurações de usuário padrão do seu domínio. O seguinte exemplo adiciona as configurações do sistema de arquivos às configurações padrão do usuário: ``` aws sagemaker update-domain --domain-id domain-id \ --default-user-settings file://file-system-settings.json ``` O exemplo passa a configuração do sistema de arquivos como um arquivo JSON, que é mostrado em um exemplo posterior. **Para adicionar um sistema de arquivos que possa ser acessado somente por um usuário individual** + Atualize o perfil do usuário. O seguinte exemplo adiciona as configurações do sistema de arquivos a um perfil de usuário: ``` aws sagemaker update-user-profile --domain-id domain-id \ --user-profile-name user-profile-name \ --user-settings file://file-system-settings.json ``` O exemplo passa a configuração do sistema de arquivos como um arquivo JSON, que é mostrado no exemplo a seguir. **Example arquivo de configurações do sistema de arquivos** O arquivo nos exemplos anteriores, `file-system-settings.json`, tem as seguintes configurações: ``` { "CustomFileSystemConfigs": [ { "FSxLustreFileSystemConfig": { "FileSystemId": "file-system-id", "FileSystemPath": "/" } } ] } ``` Essa configuração de exemplo tem as seguintes chaves: `CustomFileSystemConfigs` Configurações para sistemas de arquivos personalizados (somente sistemas de arquivos do Amazon EFS são compatíveis). `FSxLustreFileSystemConfig` Configurações personalizadas FSx para sistemas de arquivos Lustre. `FileSystemId` O ID do seu sistema de arquivos do Amazon EFS. `FileSystemPath` O caminho para o diretório do sistema de arquivos que pode ser acessado pelos usuários do domínio em seus espaços no Studio. Os usuários permitidos podem acessar somente esse diretório e abaixo. O caminho padrão é a raiz do sistema de arquivos:`/`. ``` { "CustomFileSystemConfigs": [ { "EFSFileSystemConfig": { "FileSystemId": "file-system-id", "FileSystemPath": "/" } } ] } ``` Essa configuração de exemplo tem as seguintes chaves: `CustomFileSystemConfigs` Configurações para sistemas de arquivos personalizados (somente sistemas de arquivos do Amazon EFS são compatíveis). `EFSFileSystemConfig` Configurações para sistemas de arquivos personalizados do Amazon EFS. `FileSystemId` O ID do seu sistema de arquivos do Amazon EFS. `FileSystemPath` O caminho para o diretório do sistema de arquivos que pode ser acessado pelos usuários do domínio em seus espaços no Studio. Os usuários permitidos podem acessar somente esse diretório e abaixo. O caminho padrão é a raiz do sistema de arquivos:`/`. Ao atribuir um sistema de arquivos às configurações de espaço padrão de um domínio, você também deve incluir o perfil de execução nas configurações: ``` { "ExecutionRole": "execution-role-arn" } ``` Essa configuração de exemplo tem a seguinte chave: `ExecutionRole` O perfil de execução padrão para os usuários do domínio. Se quiser aplicar permissões POSIX ao seu sistema de arquivos, você também pode passar as seguintes configurações para os comandos `create-domain` ou `create-user-profile`: ``` { "CustomPosixUserConfig": { "Uid": UID, "Gid": GID } } ``` Essa configuração de exemplo tem as seguintes chaves: `CustomPosixUserConfig` As identidades POSIX padrão usadas para operações do sistema de arquivos. Você pode usar essas configurações para aplicar sua estrutura de permissão POSIX existente aos perfis de usuário que acessam o sistema de arquivos personalizado. No nível de permissões POSIX, você pode controlar quais usuários podem acessar o sistema de arquivos e quais arquivos ou dados eles podem acessar. Você também pode aplicar configurações `CustomPosixUserConfig` ao criar um perfil de usuário usando o comando `create-user-profile`. As configurações que você aplica a um perfil de usuário substituem as que você aplica ao domínio associado. Você pode aplicar configurações `CustomPosixUserConfig` ao usar os comandos `create-domain` e `create-user-profile`. No entanto, você não pode aplicar essas configurações ao fazer o seguinte: + Use o comando `update-domain` para um domínio que já esteja associado a um perfil de usuário. Você pode aplicar essas configurações somente aos domínios que não têm perfis de usuário. + Use o comando `update-user-profile`. Para aplicar essas configurações ao perfil que você já criou, exclua o perfil e crie um novo que tenha as configurações atualizadas. `Uid` O ID do usuário POSIX. O padrão é 200001. `Gid` O ID do grupo POSIX. O padrão é 1001. ## Anexar um sistema de arquivos personalizado a um espaço com o AWS CLI Depois de adicionar um sistema de arquivos personalizado a um domínio, os usuários do domínio podem anexar o sistema de arquivos aos espaços criados por eles. Por exemplo, eles podem anexar o sistema de arquivos ao usar o Studio ou o comando [create-space](https://docs.aws.amazon.com/cli/latest/reference/sagemaker/create-space.html) com a AWS CLI. **Para anexar um sistema de arquivos personalizado a um espaço** + Adicione a configuração do sistema de arquivos às configurações de espaço. O comando de exemplo a seguir anexa um sistema de arquivos a um novo espaço. ``` aws sagemaker create-space \ --space-name space-name \ --domain-id domain-id \ --ownership-settings "OwnerUserProfileName=user-profile-name" \ --space-sharing-settings "SharingType=Private" \ --space-settings file://space-settings.json ``` No exemplo, o arquivo `space-settings.json` tem as seguintes configurações, que incluem a configuração `CustomFileSystems` com a chave `FileSystemId`: ------ #### [ For your FSx for Lustre file systems ] ``` { "AppType": "JupyterLab", "JupyterLabAppSettings": { "DefaultResourceSpec": { "InstanceType": "instance-type" } }, "CustomFileSystems": [ { "FSxLustreFileSystem": { "FileSystemId": "file-system-id" } } ] } ``` ------ #### [ For your Amazon EFS file systems ] ``` { "AppType": "JupyterLab", "JupyterLabAppSettings": { "DefaultResourceSpec": { "InstanceType": "instance-type" } }, "CustomFileSystems": [ { "EFSFileSystem": { "FileSystemId": "file-system-id" } } ] } ``` ------ SageMaker A IA cria um link simbólico no seguinte caminho:`/home/sagemaker-user/custom-file-systems/file-system-type/file-system-id`. Com isso, os usuários do domínio podem navegar até o sistema de arquivos personalizado a partir de seu diretório inicial, `/home/sagemaker-user`.