Nota

Impostazione di OCI Object Storage e Oracle API Gateway per l'hosting statico di siti Web

Introduzione

Se si dispone di un'applicazione Web che si desidera ospitare su Oracle Cloud Infrastructure (OCI) e si desidera impostare l'hosting statico di siti Web, in questa esercitazione viene illustrata la configurazione dell'hosting statico di un'applicazione Web avanzata (AOT) compilata JavaScript utilizzando OCI Object Storage e Oracle API Gateway. Lo stesso approccio può essere applicato a qualsiasi scenario in cui desideri servire un file statico su HTTP, sia per un'applicazione più semplice che per pagine Web statiche e fornire un'esperienza online affidabile ai tuoi utenti sulla piattaforma OCI, il tutto a un costo inferiore.

Obiettivi

Scopri come sfruttare OCI Object Storage e Oracle API Gateway per ospitare siti Web statici per distribuire e gestire in modo efficiente i contenuti Web su Oracle Cloud Infrastructure.

Prerequisiti

Task 1: creare un bucket di Oracle Object Storage

Iniziamo creando un nuovo bucket nello storage degli oggetti OCI. Questo bucket verrà utilizzato per ospitare il sito Web statico.

Storage degli oggetti

Task 2: caricare i file di distribuzione nel bucket

Caricare i file di distribuzione dell'applicazione nel bucket creato nel task precedente. I file di distribuzione dell'applicazione si trovano in genere nella cartella /dist della directory dell'applicazione e sono l'output della build del pacchetto Web.

File di distribuzione

Task 3: Crea richiesta preautenticata

Per consentire a Oracle API Gateway di distribuire i file di distribuzione su Internet, è necessario creare una richiesta preautenticata PAR per il bucket di storage degli oggetti in cui sono memorizzati i file di distribuzione.

Questa operazione verrà utilizzata durante la configurazione del gateway API.

Task 4: Crea Oracle API Gateway

Il servizio Oracle API Gateway ti consente di pubblicare le API con endpoint privati accessibili dall'interno della tua rete e che puoi esporre con indirizzi IP pubblici se desideri che accettino il traffico Internet. Gli endpoint supportano la convalida delle API, la trasformazione delle richieste e delle risposte, il CORS, l'autenticazione e l'autorizzazione e la limitazione delle richieste. Per ulteriori dettagli, consulta la panoramica di Oracle API Gateway.

  1. Passare al menu OCI, ai servizi per sviluppatori e al gateway API e fare clic su Crea.

Nota: sarà necessaria una rete cloud virtuale per distribuire questo Oracle API Gateway, creare una VCN se non è già stata creata.

Oracle API Gateway

Task 5: impostazione della distribuzione di Oracle API Gateway

Una volta creato correttamente Oracle API Gateway, passare a Distribuzioni e creare una nuova distribuzione.

  1. Selezionare Crea da zero e impostare il prefisso del percorso su "/". Questo sarà il percorso di base dell'URL.

    Distribuzione gateway

  2. Impostare TLS, CORS e così via qui oppure fare clic su Successivo per passare alla fase successiva.

  3. Selezionare Nessuna autenticazione e fare clic su Avanti. Non è necessario aggiungere alcuna autorizzazione per il nostro sito Web Static.

    Autenticazione distribuzione

Task 6: Aggiungi percorsi

Nella Distribuzione guidata API, aggiungere instradamenti che estenderanno il percorso di base per le nostre distribuzioni.

  1. Immettere /{req*} nel campo del percorso.

    Percorso di distribuzione

  2. Selezionare GET dall'elenco a discesa Metodi.

  3. Selezionare Modifica backend multipli aggiunti.

    Backend multipli di distribuzione

  4. Selezionare Percorso nel campo del selettore.

    Percorso di distribuzione

  5. Fare clic su Definisci backend.

  6. Creare una regola predefinita, immettere Nome come valore predefinito, Tipo di corrispondenza come Qualsiasi di e selezionare la casella di controllo Rendi predefinito, selezionare il backend come HTTP e immettere l'URL di storage degli oggetti per la pagina index.html nel campo Url, quindi fare clic su Crea.

    definizione backend

  7. Creare una regola file js, immettere Nome come js-rule, Tipo di corrispondenza come carattere jolly e *.js come espressione jolly, selezionare il backend come HTTP e immettere l'URL del bucket di storage degli oggetti seguito dalla pagina {request.path[request]} nel campo Url e fare clic su Crea. Il tuo URL avrà un aspetto simile a questo

    https://{namespace}.objectstorage.{region}.oci.customer-oci.com/n/{namespace}/b/{bucket-name}/o/${request.path[req]}

  8. Fare clic su Crea.

    definizione backend

  9. Crea regole simili per i file css, html, txt, json secondo le tue esigenze.

    il backend definisce tutto

  10. Fare clic su Successivo e completare la creazione di Oracle API Gateway e attendere l'aggiornamento.

Task 7: Test

Recuperare l'URL di distribuzione e immetterlo nel browser Web e visualizzare l'applicazione.

Note

  1. Se non viene visualizzato il caricamento dell'applicazione, verificare se è stato aggiunto il criterio corretto per Oracle API Gateway per accedere al bucket di storage degli oggetti.

  2. Non dimenticare di aggiungere tutti i diversi tipi di file dell'applicazione nella definizione backend.

  3. Solo le applicazioni compilate AOT (Ahead of Time) e i siti Web statici possono essere impostati utilizzando questa tecnica. Assicurati che la tua applicazione sia compilata in codice Javascript nativo.

Conferme

Autore - Mayank Kakani (architetto cloud OCI)

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti gratuiti sulla formazione su Oracle Learning YouTube channel. Inoltre, visita education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare Oracle Help Center.