Integração com Amazon S3#

A integração com Amazon S3 conecta os teus buckets do S3 à Ultralytics Platform. As tuas imagens permanecem nos teus buckets — a Platform indexa-as no local, para que possas navegar, anotá-las e treinar modelos YOLO sem carregar uma cópia.

Criar um utilizador IAM só de leitura#

A Platform apenas lê o teu armazenamento — nunca grava, modifica nem elimina os teus objetos. Usa um utilizador IAM dedicado com apenas permissões de listagem e leitura — nunca uses credenciais root:

1. Na consola da AWS, acede a IAM > Users e cria um utilizador sem acesso à consola.

2. Anexa uma política que conceda apenas permissões de listagem e leitura aos buckets que pretendes conectar:

   {
       "Version": "2012-10-17",
       "Statement": [
           { "Effect": "Allow", "Action": "s3:ListAllMyBuckets", "Resource": "*" },
           {
               "Effect": "Allow",
               "Action": ["s3:ListBucket", "s3:GetObject"],
               "Resource": ["arn:aws:s3:::my-bucket", "arn:aws:s3:::my-bucket/*"]
           }
       ]
   }

   s3:ListAllMyBuckets é opcional — permite que a Platform descubra os teus buckets, para que não tenhas de escrever os nomes.

3. Abre o separador Security credentials do utilizador, cria uma access key e copia o ID da chave de acesso e a chave de acesso secreta.

Conectar à Platform#

1. Acede a Settings > Integrations e seleciona Amazon S3 na lista de integrações.
2. Introduz o ID da chave de acesso, a chave de acesso secreta e a região do bucket (por exemplo, us-east-1).
3. Clica em Find available buckets e seleciona os buckets a conectar. Se a política não permitir a descoberta, introduz manualmente o nome de um bucket conhecido.
4. Clica em Connect. A Platform verifica se consegue listar e ler cada bucket selecionado antes de guardar qualquer informação.

Precisas da função de administrador ou proprietário do espaço de trabalho para conectar o armazenamento na nuvem. Uma conexão suporta até 50 buckets e a descoberta lista até 300 dos buckets a que a chave tem acesso.

Voltar a conectar o mesmo utilizador IAM mais tarde adiciona novos buckets à integração existente. Uma credencial guardada só é substituída quando a credencial de substituição ainda consegue ler todos os buckets que já conectaste.

Criar um conjunto de dados a partir de um bucket S3#

1. Clica em New Dataset e abre o separador Cloud.
2. Escolhe um bucket conectado e navega até à pasta que contém os teus dados.
3. Confirma a pasta, ajusta o nome do conjunto de dados e cria-o.

A Platform lista a pasta uma vez e cria um índice do que encontra:

• Imagens — os objetos .jpg, .jpeg, .png, .webp e .avif são indexados com dimensões lidas através de pedidos limitados. A Platform não guarda uma segunda cópia da imagem de origem.
• Rótulos — os ficheiros auxiliares .txt do YOLO são analisados e convertidos em anotações na Platform, correspondendo ao esquema padrão images/ → labels/ ou a ficheiros na mesma pasta.
• Metadados — um ficheiro YAML fornece os nomes das classes e a estrutura dos pontos-chave de pose, tal como num carregamento de arquivo. Dá-se preferência a data.yaml e data.yml quando a pasta contém vários ficheiros.
• Tarefa — uma amostra dos ficheiros de rótulos determina a tarefa, por isso as pastas de segmentação, pose e OBB são reconhecidas pela estrutura dos respetivos rótulos, e não pela tarefa escolhida na caixa de diálogo.
• Divisões — os nomes de pastas train, val e test na chave do objeto atribuem automaticamente as divisões.

A partir daí, o conjunto de dados funciona como qualquer outro: navega e anota, define-o como público ou privado, partilha-o com a tua equipa e treina com ele através do treino gerido. Os originais são transmitidos a pedido, e as imagens indexadas não consomem a tua quota de armazenamento da Platform.

Importações falhadas#

Se uma importação falhar — por uma pasta vazia, um erro de digitação no caminho ou permissões revogadas — o conjunto de dados apresenta o erro na respetiva página. Os editores podem clicar em Retry import para reiniciar a importação com o bucket e a pasta guardados, ou criar um novo conjunto de dados com o caminho corrigido.

Uma nova tentativa volta a listar a pasta em vez de continuar de onde ficou: os objetos adicionados desde a primeira tentativa são incluídos, e os objetos que já não estão lá são removidos do conjunto de dados.

Treino#

O treino gerido funciona através do fluxo de treino normal. Durante a execução, o treino usa as próprias cópias da Platform das imagens associadas, e as tuas credenciais da AWS nunca são expostas às cargas de trabalho de treino.

Desconectar uma conexão#

Desconectar elimina as credenciais armazenadas sem alterar nada na AWS. Os conjuntos de dados criados a partir desses buckets permanecem no teu espaço de trabalho com as respetivas classes, etiquetas e anotações, mas não é possível carregar, pré-visualizar nem treinar com as imagens até voltares a conectar o mesmo utilizador IAM.

Usa a REST API com o ID da integração devolvido por GET /api/integrations/buckets:

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

Para revogar o acesso na origem, desativa ou elimina a chave de acesso no AWS IAM.

Limitações atuais#

Os conjuntos de dados baseados no S3 não incluem atualmente funcionalidades que requerem cópias das imagens geridas pela Platform: anotação automática, análise de agrupamento, clonagem de conjuntos de dados e instantâneos de versões imutáveis.

Eliminar um conjunto de dados baseado no S3, ou imagens individuais desse conjunto, remove apenas as referências da Platform — os teus objetos nunca são alterados.

Consulta também as integrações com Google Cloud Storage e Azure Blob Storage.

Perguntas frequentes#