Risoluzione dei problemi
Cosa verificare quando una build non riesce, una modifica non è online, un dominio resta in attesa o una richiesta viene rifiutata.
Una build non è riuscita
Apri la build: error fornisce un codice e un messaggio, mentre il log mostra l’output del compilatore (i messaggi di Astro). Le cause più comuni:
- Un valore del contenuto che non corrisponde allo schema. Il log indica il campo. Correggi il contenuto, non lo schema, a meno che tu non voglia aggiungere un nuovo tipo di dato.
- Una dipendenza non disponibile per la build. La build viene eseguita senza accesso alla rete e usa i pacchetti disponibili su Atelier201, quindi un progetto che aggiunge un altro pacchetto o una versione diversa viene rifiutato.
dependencies_unavailableindica questo problema e il messaggio specifica il pacchetto. - Un problema dell’infrastruttura.
build_infrastructureindica un problema del container di build o dello spazio di archiviazione, non dei tuoi file. Esegui di nuovo la build.
Una build pronta della stessa revisione viene riutilizzata, quindi esegui di nuovo la build dopo aver applicato una correzione, non prima.
Ho pubblicato, ma i visitatori vedono ancora il vecchio sito
La pubblicazione raggiunge tutti gli indirizzi in circa un minuto. Se la vecchia versione è ancora visibile dopo questo intervallo, verifica di aver pubblicato la build prevista:
atelier201 publish history e published.build_id del sito indicano quale versione è online.
Pubblicare di nuovo o eseguire un rollback riscrive il routing del sito.
La pubblicazione viene rifiutata
| Messaggio o codice | Causa |
|---|---|
409 conflict dopo una revisione | Qualcuno ha pubblicato dopo la tua revisione. Esegui di nuovo la revisione e invia il nuovo expected_generation. |
409 conflict con l’elenco dei blocchi | La build non può essere messa online. Ogni blocco indica cosa fare: consulta Come va online un sito. |
403 insufficient_scope | La credenziale non dispone dell’autorizzazione sites:publish. Chiedi al proprietario di pubblicare oppure riconnettiti includendo tale autorizzazione. |
403 admin_required | Solo un amministratore del workspace può pubblicare. |
Una modifica è stata rifiutata per un conflitto
Hai modificato un file che qualcuno aveva cambiato dopo che lo avevi letto. details dell’errore contiene la revisione corrente e i percorsi. Rileggi quei file e applica le tue modifiche alla versione più recente.
Un dominio resta in attesa
Un dominio passa da pending_ownership a provisioning e poi ad active quando i suoi record sono disponibili. Se resta in pending_ownership, il record TXT manca o non si è ancora propagato. Confrontalo con i record indicati nell’app, attendi e verifica di nuovo il dominio. Un conflitto con un messaggio relativo al piano significa che al sito non resta alcun dominio personalizzato: rimuovine uno oppure passa il sito a un piano superiore.
È stato raggiunto un limite del piano
La pubblicazione di una bozza viene rifiutata con 403 feature_not_available; la creazione di una bozza oltre il limite del workspace e la connessione di un dominio a una bozza vengono rifiutate con 409 conflict. Ogni messaggio indica il limite e include un collegamento alla pagina che permette di rimuoverlo (action_url). Passa il sito al piano Site oppure elimina una bozza, quindi riprova. Un agente non deve riprovare all’infinito né modificare autonomamente il piano.
Il saldo dei crediti non sembra corretto
Il saldo corrisponde alla somma dei crediti non scaduti, meno quelli utilizzati. La pagina Fatturazione elenca ogni accredito e la relativa data di scadenza. Solo le funzioni AI consumano crediti: l’assistente e le immagini o i video creati con l’AI.
Non riesco ad accedere
Verifica quale indirizzo email è associato all’account. Un account creato con Google e uno creato con una password sono lo stesso account solo se usano lo stesso indirizzo.