Imposta 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 di siti Web statici, in questa esercitazione viene illustrata la configurazione dell'hosting statico di un'applicazione Web JavaScript ricca di Ahead-of-Time (AOT) compilata utilizzando OCI Object Storage e Oracle API Gateway. Lo stesso approccio può essere applicato a qualsiasi scenario in cui si desidera servire un file statico su HTTP, sia per un'applicazione più semplice che per pagine Web statiche e fornire un'esperienza online affidabile agli 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 storage degli oggetti Oracle

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

Bucket di 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 webpack.

File di distribuzione

Suggerimento: se si desidera utilizzare oci-cli per caricare i file, assicurarsi di specificare il parametro --content-type auto per assicurarsi che Content-Type venga impostato correttamente.

Task 3: Creare una richiesta preautenticata

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

Lo utilizzeremo durante la configurazione del gateway API.

Task 4: Crea Oracle API Gateway

Il servizio Oracle API Gateway ti consente di pubblicare 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 dell'API, la trasformazione di richieste e risposte, CORS, autenticazione e autorizzazione e limitazione delle richieste. Per ulteriori dettagli, vedere Panoramica di Oracle API Gateway.

  1. Andare a Menu OCI, Servizi per sviluppatori, Gateway API e fare clic su Crea.

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

Oracle API Gateway

Task 5: Impostazione distribuzione di Oracle API Gateway

Una volta creato Oracle API Gateway, vai a Distribuzioni e crea una nuova distribuzione.

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

    Distribuzione gateway

  2. Impostare TLS, CORS e così via qui o fare clic su Successivo per passare al passo successivo.

  3. Selezionare Nessuna autenticazione e fare clic su Successivo. Non abbiamo bisogno di aggiungere alcuna autenticazione per il nostro sito statico.

    Autorizzazione distribuzione

Task 6: Aggiungi percorsi

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

  1. Immettere /{req*} nel campo Percorso.

    Percorso di distribuzione

  2. Selezionare GET dall'elenco a discesa Metodi.

  3. Selezionare Modifica backend multipli aggiunti.

    Distribuzione di più backend

  4. Selezionare Percorso nel campo del selettore.

    Percorso di distribuzione

  5. Fare clic su Definisci backend.

  6. Creare una regola predefinita, immettere Nome come predefinito, Tipo di corrispondenza come Qualsiasi, quindi 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 e 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[req]} nel campo URL e fare clic su Crea. L'URL sarà 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 in base alle esigenze.

    definire tutto il backend

  10. Fare clic su Avanti e completare la creazione di Oracle API Gateway e attendere che venga aggiornato.

Task 7: Test

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

Note

  1. Se l'applicazione non viene caricata, verificare se la lista di sicurezza o il gruppo di sicurezza di rete nella VCN consente il traffico verso Oracle API Gateway.

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

  3. Solo le applicazioni compilate AOT (Ahead of Time) e i siti web statici possono essere impostati utilizzando questa tecnica. Assicurarsi che l'applicazione sia compilata in codice Javascript nativo.

Conferme

Autore: Mayank Kakani (OCI Cloud Architect)

Altre risorse di apprendimento

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

Per la documentazione del prodotto, visitare Oracle Help Center.