App Storage

O App Storage é o armazenamento de objetos integrado do Replit que permite que seu app hospede e salve facilmente uploads como imagens, vídeos e documentos. Buckets são contêineres para armazenar objetos, como arquivos. Eles incluem políticas de acesso para limitar quais ações usuários ou aplicações podem executar sobre seu conteúdo. Com o App Storage, você pode criar apps como:

• Plataformas de compartilhamento de fotos: permita que criadores façam upload, armazenem e exibam imagens
• Serviços de streaming de vídeo: gerencie uploads de vídeo e forneça conteúdo aos espectadores
• Sistemas de gerenciamento de documentos: armazene e organize arquivos de criadores com acesso seguro
• Sites de portfólio: exiba trabalhos com arquivos de mídia que carregam de forma confiável
• Serviços de backup de arquivos: forneça aos criadores armazenamento em nuvem para seus arquivos importantes

A ferramenta App Storage permite que você compartilhe dados perfeitamente entre seus ambientes de desenvolvimento e produção ou com outros Replit Apps.

​

Recursos

O App Storage oferece os seguintes recursos para seus Replit Apps:

• Armazenamento em nuvem persistente: armazene arquivos que permanecem acessíveis ao seu app publicado e aos usuários
• Gerenciamento de arquivos escalável: atenda às necessidades crescentes de dados sem se preocupar com limites de armazenamento
• Compartilhamento de dados entre apps: compartilhe buckets entre vários Replit Apps para arquiteturas distribuídas
• Acesso programático: faça upload, download e gerencie arquivos usando APIs intuitivas
• Integração avançada com o Agent: deixe o Agent configurar o App Storage com configurações avançadas, inspecionar configurações existentes e gerar código completo de back-end e front-end com autenticação e controles de acesso

Aqui estão algumas maneiras de usar o App Storage nos seus Replit Apps:

• Armazenar fotos de perfil de criadores e uploads de mídia
• Servir imagens de produtos para sites de e-commerce
• Gerenciar uploads de documentos para envios de formulários
• Criar recursos de compartilhamento e colaboração de arquivos
• Criar sistemas de gerenciamento de conteúdo com bibliotecas de mídia

​

Uso

Você pode acessar a ferramenta App Storage diretamente no seu Project Editor.

Como acessar a ferramenta App Storage

No Tool dock à esquerda:

1. Selecione All tools para ver uma lista das ferramentas do Project Editor.
2. Selecione App Storage.

Na barra de pesquisa:

1. Selecione a lupa no topo para abrir a ferramenta de pesquisa.
2. Digite “App Storage” para localizar a ferramenta e selecione-a nos resultados.

Para associar um novo bucket de armazenamento ao seu Replit App, crie um bucket.

Como criar um bucket

Na ferramenta App Storage:

1. Clique em Create new bucket.
2. Digite um nome para o bucket no campo Name e selecione Create bucket.

A aba App Storage deve se parecer com a captura de tela a seguir:

Para criar buckets adicionais, abra o menu suspenso de buckets no canto superior esquerdo da aba App Storage e selecione Create new bucket.

As seções a seguir explicam as opções de gerenciamento de buckets e objetos na ferramenta App Storage.

​

Selecionar um bucket

Para alternar entre seus buckets de armazenamento, selecione o menu suspenso no canto superior esquerdo da aba App Storage. O bucket selecionado exibe uma marca de seleção ao lado do seu nome, como mostrado na captura de tela abaixo:

​

Acessar o ID do bucket

Para visualizar o Bucket ID, selecione a visualização Settings no menu suspenso no topo da aba App Storage. O Bucket ID identifica exclusivamente o bucket, que seu código deve referenciar para realizar uma operação. Se você tiver vários buckets, selecione o bucket correto no menu suspenso no canto superior esquerdo. A captura de tela a seguir mostra o Bucket ID do bucket “FileVault Bucket One”:

​

Fazer upload ou download de objetos

Para fazer upload de um objeto para o bucket selecionado:

1. Navegue até a visualização Objects na aba App Storage.
2. Selecione Upload files, ou Upload folder para fazer upload de todos os arquivos de uma pasta. Em seguida, selecione um ou mais arquivos para fazer upload na caixa de diálogo de arquivos. Alternativamente, arraste um arquivo ou pasta para a área que lista o conteúdo do bucket.

Para fazer download de um objeto do bucket selecionado:

1. Navegue até a visualização Objects na aba App Storage.
2. Selecione o ícone de download à direita do arquivo para baixá-lo.

​

Organizar objetos em pastas

Para criar uma pasta no bucket selecionado:

1. Navegue até a visualização Objects na aba App Storage.
2. Selecione Create Folder na visualização Objects.
3. Digite um nome para a pasta.

Para adicionar objetos a uma pasta na visualização Objects, arraste um objeto até a pasta de destino. Para mover o objeto para uma pasta pai, arraste-o sobre o cabeçalho até o nome da pasta acima da lista de objetos. A animação a seguir mostra a movimentação do arquivo “product_demo.mov” da pasta “videos” para a pasta pai “Objects”:

​

Excluir objetos ou buckets

Para excluir um objeto permanentemente:

1. Navegue até a visualização Objects na aba App Storage.
2. Selecione o ícone de lixeira ao lado do objeto que você deseja excluir.
3. Confirme a exclusão na caixa de diálogo de confirmação.

Para excluir um bucket e todos os objetos que ele contém:

1. Navegue até a visualização Settings na aba App Storage.
2. Certifique-se de selecionar o bucket que deseja excluir no menu suspenso de buckets no canto superior esquerdo.
3. Selecione Delete Bucket.
4. Confirme a exclusão na caixa de diálogo de confirmação.

​

Gerenciamento de acesso a buckets

O Replit conecta todos os buckets que você cria à sua conta e os disponibiliza para todos os seus Replit Apps. O Replit App a partir do qual você cria o bucket recebe acesso automaticamente. Você pode controlar quais dos seus Replit Apps têm acesso a um bucket específico, o que permite compartilhar dados de forma eficiente e segura. Para conceder ao seu Replit App acesso a um bucket de outro app na sua conta:

1. Selecione Add an existing bucket no menu de buckets no canto superior esquerdo da aba App Storage.
2. Na caixa de diálogo Choose a Bucket, escolha o bucket que deseja adicionar e selecione Add Bucket to Repl.

Para revogar o acesso do seu Replit App a um bucket:

1. Navegue até a visualização Settings na aba App Storage.
2. No menu suspenso de buckets no canto superior esquerdo da aba, selecione o nome do bucket.
3. Selecione Remove Bucket from Repl e confirme a remoção na caixa de diálogo de confirmação.

​

Acesso programático ao App Storage

Para acessar o App Storage a partir do seu Replit App, use uma das seguintes bibliotecas:

• SDK de App Storage do Replit, disponível para JavaScript e Python
• Biblioteca de cliente do Google Cloud Storage

Para instruções sobre como usar as bibliotecas de cliente, veja os seguintes recursos:

• JavaScript App Storage SDK: referência de cliente para o SDK de JavaScript
• Python App Storage SDK: referência de cliente para o SDK de Python
• Google Cloud Python SDK example app: faça remix deste app para gerenciar objetos usando o SDK Python do Google Cloud

​

Faturamento e uso de recursos

Para monitorar seu uso de App Storage, navegue até a página Usage. Para saber mais sobre os preços do App Storage, veja App Storage Billing.