> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/s3.md). # S3 {% hint style="info" %} Questo documento copre la configurazione di S3 in Server CE e Overleaf Pro. Un [guida separata](/on-premises/it/manutenzione/s3-migration.md) si trova sulla migrazione dei dati esistenti verso uno storage compatibile con S3. {% endhint %} ## Quando considerare l'uso di S3 per l'archiviazione dei dati Per istanze con meno di 1000 posti consigliamo di usare l'archiviazione su disco locale con backup regolari [coerenti](https://docs.overleaf.com/on-premises/maintenance/data-and-backups#performing-a-consistent-backup). Per istanze più grandi, con più di 1000 posti, che raggiungono i limiti del loro storage locale (dimensione o throughput), consigliamo di usare un backend di object storage compatibile con S3 invece di altre soluzioni di storage basate sulla rete come NFS. ## Opzioni di object storage compatibili con S3 Ecco le opzioni più popolari per l'object storage compatibile con S3: * [AWS S3](https://aws.amazon.com/s3/), gestito, suggeriamo di scegliere AWS S3 quando si esegue Overleaf CE/Server Pro su AWS * [MINIO](https://min.io/), self-hosted * [Ceph](https://ceph.io/en/), self-hosted * Anche altri provider di hosting dispongono di una qualche forma di object storage gestito compatibile con S3; potresti voler usare questi invece di gestirne uno tuo quando stai già eseguendo Overleaf CE/Server Pro presso tale provider. ## Considerazioni sulla latenza quando si sceglie un object storage compatibile con S3 La latenza tra l'istanza Server CE/Server Pro e il tuo object storage compatibile con S3 contribuisce in modo significativo al tempo necessario per completare la migrazione. La latenza influisce anche sulle prestazioni di caricamento dei file in Server CE/Server Pro e i download lenti possono avere un forte impatto anche sui tempi di compilazione dei PDF. Suggeriamo di ridurre al minimo la distanza geografica tra la tua istanza Server CE/Server Pro e l'object storage compatibile con S3. In un ambiente gestito, ciò significherebbe provisioning di un bucket nella stessa regione; per una soluzione on-premise, eseguire i due nella stessa sede. ## Configurazione S3 Abbiamo bisogno di quattro "bucket" e di due account utente limitati. {% hint style="warning" %} I bucket dovrebbero **non** essere accessibili pubblicamente {% endhint %}
BucketUtilizzoServizioIn precedenza in /var/lib/overleaf/data
overleaf-user-filesfile utente del progettofilestoreuser_files
overleaf-template-filesfile del templatefilestoretemplate_files
overleaf-project-blobsblob della cronologia del progettocronologia e archivio file in sola letturahistory/overleaf-project-blobs
overleaf-chunkschunk della cronologiahistoryhistory/overleaf-chunks
Potresti voler/aver bisogno di scegliere un nome diverso; assicurati di usare i bucket personalizzati in tutti i comandi. Quanto segue userà dei segnaposto per le credenziali effettive:
Variabile d'ambienteDescrizione
OVERLEAF_FILESTORE_S3_ACCESS_KEY_IDLa access key/username dell'utente limitato del servizio filestore.
OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEYLa secret key/password dell'utente limitato del servizio filestore.
OVERLEAF_HISTORY_S3_ACCESS_KEY_IDLa access key/username dell'utente limitato del servizio history.
OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEYLa secret key/password dell'utente limitato del servizio history.
Server CE e Server Pro necessitano solo di un piccolo insieme di permessi su ogni bucket: * crea oggetto * ottieni oggetto * elimina oggetto * elenca bucket ### Policy di accesso Ecco come potrebbe apparire una policy per l'utente del filestore: ```json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-user-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-user-files/*" }, { "Effect": "Allow", "Action": [ "s3:GetObject", ], "Resource": "arn:aws:s3:::overleaf-project-blobs/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-template-files" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-template-files/*" } ] } ``` Ecco come potrebbe apparire una policy per l'utente della cronologia: ```json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-project-blobs" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-project-blobs/*" }, { "Effect": "Allow", "Action": [ "s3:ListBucket" ], "Resource": "arn:aws:s3:::overleaf-chunks" }, { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject" ], "Resource": "arn:aws:s3:::overleaf-chunks/*" } ] } ``` ### Panoramica delle variabili #### Quando si usa AWS S3 ```bash # Abilita il backend S3 per il filestore OVERLEAF_FILESTORE_BACKEND=s3 # Nome del bucket per i file del progetto OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME=overleaf-user-files # Nome del bucket per i file del template OVERLEAF_FILESTORE_TEMPLATE_FILES_BUCKET_NAME=overleaf-template-files # Chiave per l'utente del filestore OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID=... # Segreto per l'utente del filestore OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY=... # Regione del bucket scelta quando hai creato i bucket. OVERLEAF_FILESTORE_S3_REGION="" # Abilita il backend S3 per la cronologia OVERLEAF_HISTORY_BACKEND=s3 # Nome del bucket per i blob della cronologia del progetto OVERLEAF_HISTORY_PROJECT_BLOBS_BUCKET=overleaf-project-blobs # Nome del bucket per i chunk della cronologia OVERLEAF_HISTORY_CHUNKS_BUCKET=overleaf-chunks # Chiave per l'utente della cronologia OVERLEAF_HISTORY_S3_ACCESS_KEY_ID=... # Segreto per l'utente della cronologia OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY=... # Regione del bucket scelta quando hai creato i bucket. OVERLEAF_HISTORY_S3_REGION="" ``` #### Quando si usa un'opzione self-hosted ```bash # Abilita il backend S3 per il filestore OVERLEAF_FILESTORE_BACKEND=s3 # Nome del bucket per i file del progetto OVERLEAF_FILESTORE_USER_FILES_BUCKET_NAME=overleaf-user-files # Nome del bucket per i file del template OVERLEAF_FILESTORE_TEMPLATE_FILES_BUCKET_NAME=overleaf-template-files # Chiave per l'utente del filestore OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID=... # Segreto per l'utente del filestore OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY=... # Endpoint del provider S3 OVERLEAF_FILESTORE_S3_ENDPOINT=http://10.10.10.10:9000 # Addressing dei bucket in path-style. Molto probabilmente devi impostarlo su "true". OVERLEAF_FILESTORE_S3_PATH_STYLE="true" # Regione del bucket. Molto probabilmente non è necessario configurarla. OVERLEAF_FILESTORE_S3_REGION="" # Abilita il backend S3 per la cronologia OVERLEAF_HISTORY_BACKEND=s3 # Nome del bucket per i blob della cronologia del progetto OVERLEAF_HISTORY_PROJECT_BLOBS_BUCKET=overleaf-project-blobs # Nome del bucket per i chunk della cronologia OVERLEAF_HISTORY_CHUNKS_BUCKET=overleaf-chunks # Chiave per l'utente della cronologia OVERLEAF_HISTORY_S3_ACCESS_KEY_ID=... # Segreto per l'utente della cronologia OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY=... # Endpoint del provider S3 OVERLEAF_HISTORY_S3_ENDPOINT=http://10.10.10.10:9000 # Addressing dei bucket in path-style. Molto probabilmente devi impostarlo su "true". OVERLEAF_HISTORY_S3_PATH_STYLE="true" # Regione del bucket. Molto probabilmente non è necessario configurarla. OVERLEAF_HISTORY_S3_REGION="" ``` ### Configurazione MINIO {% hint style="info" %} `MINIO_ROOT_USER` e `MINIO_ROOT_PASSWORD` sono le credenziali root dell'istanza MINIO. {% endhint %} Segui [la documentazione ufficiale](https://min.io/docs/minio/linux/reference/minio-mc.html#quickstart) per ottenere una copia di `mc`. ```bash mc alias set s3 http://10.10.10.10:9000 MINIO_ROOT_USER MINIO_ROOT_PASSWORD # Inserisci il contenuto delle policy della sezione precedente nei # rispettivi file json policy-filestore.json e policy-history.json. # Promemoria: sostituisci di conseguenza i nomi dei bucket e le credenziali. # bucket, utente e policy del filestore mc mb --ignore-existing s3/overleaf-user-files mc mb --ignore-existing s3/overleaf-template-files mc admin user add s3 \ OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID \ OVERLEAF_FILESTORE_S3_SECRET_ACCESS_KEY mc admin policy create s3 overleaf-filestore policy-filestore.json mc admin policy attach s3 overleaf-filestore \ --user=OVERLEAF_FILESTORE_S3_ACCESS_KEY_ID # bucket, utente e policy della cronologia mc mb --ignore-existing s3/overleaf-project-blobs mc mb --ignore-existing s3/overleaf-chunks mc admin user add s3 \ OVERLEAF_HISTORY_S3_ACCESS_KEY_ID \ OVERLEAF_HISTORY_S3_SECRET_ACCESS_KEY mc admin policy create s3 overleaf-history policy-history.json mc admin policy attach s3 overleaf-history \ --user=OVERLEAF_HISTORY_S3_ACCESS_KEY_ID ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ayakaleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/s3.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.