Link to this sectionIntegração com Amazon S3#
A integração com o Amazon S3 conecta os teus buckets S3 à Ultralytics Platform. As tuas imagens permanecem nos teus buckets — a Platform indexa-as no local, para que possas navegar, anotar e treinar modelos YOLO sem carregar uma cópia.
Os datasets do Amazon S3 requerem um plano Pro ou Enterprise. Workspaces gratuitos visualizam a integração e recebem uma notificação para atualizar ao conectar. Datasets do Amazon S3 existentes permanecem totalmente acessíveis se uma subscrição terminar — apenas novas conexões e importações requerem o plano Pro.
Link to this sectionCriar um utilizador IAM apenas de leitura#
A Platform apenas lê do teu armazenamento — nunca escreve, modifica ou elimina os teus objetos. Usa um utilizador IAM dedicado apenas com acesso de listagem e leitura — nunca uses credenciais root:
-
Na consola da AWS, vai a IAM > Users e cria um utilizador sem acesso à consola.
-
Anexa uma política que conceda apenas acesso de listagem e leitura aos buckets que queres 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 manualmente. -
Abre o separador Security credentials do utilizador, cria uma access key e copia o access key ID e a secret access key.
Link to this sectionConecte-se à Platform#
- Vai a Settings > Integrations e encontra o cartão Amazon S3.
- Clica em Connect e insere o access key ID, a secret access key e a região do bucket (por exemplo,
us-east-1). - A Platform lista os buckets que a credencial consegue ler. Seleciona os que queres conectar ou insere o nome de um bucket manualmente se a política não permitir a descoberta.
- Clique em Connect. A Platform verifica se consegue listar e ler cada bucket selecionado antes de salvar qualquer informação.
Reconectar o mesmo utilizador IAM mais tarde adiciona novos buckets à integração existente. Uma credencial guardada só é substituída quando a sua substituta ainda conseguir ler todos os buckets que já conectaste.
Uma conexão lê buckets na região que inserires. Se os teus buckets estiverem em várias regiões, conecta uma vez por região.
As credenciais são encriptadas em repouso com AES-256-GCM, nunca são devolvidas ao navegador e nunca entram nos payloads de trabalhos de treino. Para revogar o acesso, desativa a access key no AWS IAM.
Link to this sectionCriar um dataset a partir de um bucket S3#
- Clique em New Dataset e abra a aba Cloud storage.
- Escolha um bucket conectado e navegue até a pasta que contém seus dados.
- Confirme a pasta, ajuste o nome do dataset e crie o dataset.
A Platform lista a pasta uma vez e indexa o que encontra:
- Imagens — Objetos
.jpg,.jpeg,.png,.webpe.avifsão indexados com dimensões lidas a partir de solicitações de cabeçalho delimitadas. Os pixels originais nunca são copiados para fora do seu bucket. - Rótulos — arquivos auxiliares YOLO
.txtsão analisados para anotações da Platform, correspondidos pelo layout padrãoimages/→labels/ou como irmãos na mesma pasta. - Metadados — um
data.yaml/data.ymlfornece nomes de classes, tipo de tarefa e formato de keypoints de pose, exatamente como um envio de arquivo compactado. - Splits — nomes de pastas
train,valetestna chave do objeto atribuem os splits automaticamente.
O dataset então se comporta como qualquer outro: navegue e anote-o, defina-o como público ou privado, compartilhe-o com sua equipe e treine nele através de treinamento gerenciado. Os originais são transmitidos sob demanda, e imagens indexadas não consomem sua cota de armazenamento da Platform.
Uma única importação indexa até 50.000 objetos, e arquivos de rótulo ou YAML de até 1 MB cada. Buckets maiores devem ser divididos em vários datasets.
Cada imagem indexada está fixada ao seu ETag de objeto S3, e a Platform falha de forma segura se um objeto for alterado. Adiciona novos objetos em vez de sobrescrever os existentes.
Link to this sectionImportações com falha#
Se uma importação falhar — uma pasta vazia, um erro de digitação no caminho ou permissões revogadas — o dataset exibirá o erro na sua página. Editores podem clicar em Retry import para reiniciar com o bucket e a pasta armazenados, ou criar um novo dataset apontando para o caminho corrigido.
Link to this sectionTreinamento#
O treino gerido funciona através do fluxo de treino normal. Os workers descarregam os originais fixados para um armazenamento de trabalho temporário durante a execução e removem-nos com a limpeza do trabalho — as tuas credenciais AWS nunca chegam à computação.
Link to this sectionLimitações atuais#
Datasets baseados em S3 excluem atualmente funcionalidades que requerem cópias das tuas imagens pertencentes à Platform: auto-anotação, análise de clustering, clonagem de datasets e snapshots de versão imutáveis.
Eliminar um dataset baseado em S3, ou imagens individuais dele, remove apenas as referências da Platform — os teus objetos nunca são tocados.
Vê também as integrações com Google Cloud Storage e Azure Blob Storage.