Como solucionar problemas associados à conexão de repositórios Git a instâncias de caderno do Amazon SageMaker?

Resolução

Para adicionar um novo repositório Git à sua instância do notebook SageMaker, consulte Adicione um repositório Git à sua conta do Amazon SageMaker. Se você estiver tentando adicionar um repositório Git que não esteja hospedado no AWS CodeCommit, você pode receber os seguintes erros.

Erros associados à conectividade

Se houver problemas de conectividade, você poderá receber um dos seguintes erros:

• “fatal: não foi possível acessar <Git repository URL>: o URL solicitado retornou um erro: 403"
• “fatal: não foi possível acessar <Git repository URL>: falha na conexão com...: porta 443: a conexão atingiu o tempo limite"
• “fatal: não foi possível acessar <Git repository URL> não foi possível resolver o host: ..."

Para resolver esses erros, faça o seguinte:

• Verifique a conectividade da instância do notebook.
• Verifique a precisão do URL do repositório Git.

Verifique a conectividade da instância do notebook

Confirme se a instância do notebook se conectou ao repositório Git. Esse repositório pode estar localizado em um servidor de repositório Git on-premises ou em um servidor de nuvem pública, como GitHub, Bitbucket ou GitLab.

Verifique a configuração de rede que sua instância de notebook está usando. A instância do notebook pode ter uma das seguintes configurações de rede:

• A instância não está conectada a uma Amazon Virtual Private Cloud (VPC).
• Sua Amazon VPC tem acesso direto à Internet
• Sua VPC não tem acesso direto à Internet.

Se você usa uma VPC, certifique-se de que as sub-redes, os grupos de segurança, as listas de controle de acesso à rede (ACLs), o gateway NAT, o gateway da Internet e as tabelas de rotas estejam configurados corretamente.

Verifique a precisão do URL do repositório Git

Certifique-se de que o URL do repositório Git que você está adicionando esteja no seguinte formato:

• URL do GitHub: <workspace>/<repository.git>
• URL do Bitbucket: <workspace>/<repository.git>
• URL do GitLab: <workspace>/<repository.git>

Certifique-se de substituir o seguinte:

• workspace pelo nome do espaço de trabalho Git
• repository.git pelo nome do repositório de código que tem a extensão de arquivo *.git.

Por exemplo, se você estiver usando o Bitbucket como um repositório Git em que o nome do seu espaço de trabalho é myworkspace e seu repositório do Git é myrepository.git, você deve usar o seguinte URL do repositório Git:

Erros associados à autenticação

Se houver problemas de autenticação, você poderá receber um dos seguintes erros:

• “fatal: não foi possível ler o nome de usuário de <Git repository URL>: avisos de terminal desativados"
• “fatal: não foi possível ler a senha de <Git repository URL>: avisos de terminal desativados"
• “fatal: falha na autenticação de <Git repository URL>"

Para resolver esses erros, faça o seguinte:

• Verifique os detalhes da autenticação.
• Verifique se o usuário ou os perfis do AWS Identity and Access Management (IAM) têm as permissões necessárias para acessar o AWS Secrets Manager.

Verifique se os detalhes da autenticação estão corretos

Certifique-se de que o nome de usuário e a senha estejam corretos no Secrets Manager.

• GitHub: se você ativou a autenticação de dois fatores, deverá usar um token de acesso pessoal em vez de uma senha. Depois que esse token for gerado, você deverá atualizar a senha no Secrets Manager com esse novo token.
• Bitbucket: O Bitbucket não oferece suporte a senhas de conta para autenticação Git. É uma prática recomendada criar senhas de aplicações usando suas Configurações pessoais. Depois de criar a senha da aplicação, você deve atualizar a senha no Secrets Manager.
• GitLab: se você ativou a autenticação de dois fatores, deverá usar um token de acesso pessoal em vez de uma senha. Depois que esse token for gerado, você deverá atualizar a senha no Secrets Manager com esse novo token.

Verifique se o perfil do IAM da instância do notebook tem as permissões necessárias

Verifique se o perfil do IAM usado para a instância do notebook tem a permissão secretsmanager:GetSecretValue anexada em sua política do IAM. Se o perfil do IAM não tiver as permissões necessárias, você poderá adicionar a seguinte política ao perfil:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Resource": [
        "example-secret-ARN"
      ]
    },
    {
      "Effect": "Allow",
      "Action": "secretsmanager:ListSecrets",
      "Resource": "*"
    }
  ]
}

Observação: example-secret-ARN é o ARN no Secrets Manager que contém os segredos (nome de usuário e senha) da autenticação do repositório Git.

Erros associados ao armazenamento

Se houver problemas relacionados ao armazenamento, você poderá receber o seguinte erro:

Não há mais espaço no dispositivo ao clonar o repositório Git. Tente usar um volume maior

Para resolver esse erro, verifique se a instância do notebook tem armazenamento suficiente. Certifique-se de que o tamanho do espaço livre no volume da instância do notebook seja maior do que o do repositório Git que você está usando para clonar. Se você ficar sem espaço em disco, especifique um valor maior para VolumeSizeInGB. Para obter mais informações, consulte Personalizar o tamanho do volume do seu notebook, até 16 TB, com o Amazon SageMaker.

---

Informações relacionadas

Associe repositórios Git a instâncias do notebook do SageMaker

Uso do AWS CodeCommit com endpoints da VPC da interface