Aggiunta di app - AWS OpsWorks

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiunta di app

Importante

Il AWS OpsWorks Stacks servizio ha raggiunto la fine del ciclo di vita il 26 maggio 2024 ed è stato disabilitato sia per i clienti nuovi che per quelli esistenti. Consigliamo vivamente ai clienti di migrare i propri carichi di lavoro verso altre soluzioni il prima possibile. Se hai domande sulla migrazione, contatta il AWS Support Team su AWS re:post o tramite Premium AWS Support.

La prima fase del processo di distribuzione di un'applicazione nei server di applicazioni prevede l'aggiunta di un'app allo stack. L'app rappresenta l'applicazione e contiene una serie di metadati, ad esempio il nome e il tipo dell'applicazione, nonché le informazioni necessarie per distribuire l'applicazione sulle istanze del server, ad esempio l'URL dell'archivio. Devi disporre delle autorizzazioni Manage (Gestione) per aggiungere un'app a uno stack. Per ulteriori informazioni, consulta Gestione delle autorizzazioni utente.

Nota

La procedura in questa sezione è valida per stack Chef 12 e stack di versioni più recenti. Per ulteriori informazioni su come aggiungere app ai livelli negli stack Chef 11, consulta Fase 2.4: Creazione e distribuzione di un'app - Chef 11.

Per aggiungere un'app a uno stack.
  1. Inserisci il codice nel tuo repository preferito: un archivio Amazon S3, un repository Git, un repository Subversion o un archivio HTTP. Per ulteriori informazioni, consulta Origine dell'applicazione.

  2. Fare clic su Apps (App) nel riquadro di navigazione. Nella pagina Apps (App) fare clic su Add an app (Aggiungi un'app) per la prima app. Per le app successive, fare clic su +App.

  3. Utilizzare la pagina App New (Nuova app) per configurare l'app, come descritto nella sezione seguente.

Configurazione di un'app

La pagina Add App (Aggiungi app) è composta dalle seguenti sezioni: Settings (Impostazioni), Application source (Origine applicazione), Data Sources (Origini dati), Environment Variables (Variabili di ambiente), Add Domains (Aggiungi domini) e SSL Settings (Impostazioni SSL).

Impostazioni

Nome

Il nome dell'app, utilizzato per rappresentare l'app nell'interfaccia utente. AWS OpsWorks Stacks utilizza questo nome anche per generare un nome breve per l'app che viene utilizzato internamente e per identificare l'app negli attributi di configurazione e distribuzione dello stack. Dopo aver aggiunto l'app allo stack, per visualizzare il nome breve fare clic su Apps (App) nel riquadro di navigazione e quindi scegliere il nome dell'app per aprire la pagina dei dettagli.

Document root (Radice documento)

AWS OpsWorks Stacks assegna l'impostazione root del documento all'[:document_root]attributo negli attributi dell'app. deploy Il valore predefinito è null. Le ricette di distribuzione possono recuperare tale valore dagli attributi deploy tramite la sintassi di nodo Chef standard e quindi distribuire il codice specificato nella posizione appropriata sul server. Per ulteriori informazioni su come distribuire le app, consulta Ricette di ditribuzione.

Origine dell'applicazione

Puoi distribuire app dai seguenti tipi di repository: Git, pacchetto Amazon S3, pacchetto HTTP e Altro. Tutti i tipi di archivio richiedono di specificare il tipo e l'URL dell'archivio. I singoli tipi di archivio hanno requisiti propri, come descritto di seguito.

Nota

AWS OpsWorks Stacks distribuisce automaticamente le applicazioni dai repository standard ai livelli server integrati. Se utilizzi il tipo di repository Altro, che è l'unica opzione per gli stack di Windows, AWS OpsWorks Stacks inserisce le informazioni del repository negli deployattributi dell'app, ma devi implementare ricette personalizzate per gestire le attività di distribuzione.

Archivio HTTP

Per usare come archivio un server HTTP accessibile pubblicamente:

  1. Crea un archivio compresso (zip, gzip, bzip2, Java WAR o tarball) della cartella che contiene il codice dell'app e gli eventuali file associati.

    Nota

    AWS OpsWorks Stacks non supporta archivi tar non compressi.

  2. Caricare il file di archivio sul server.

  3. Per specificare l'archivio nella console, selezionare HTTP Archive (Archivio HTTP) come tipo di repository e immettere l'URL.

    Se l'archivio è protetto da password, in Application Source, specifica le credenziali di accesso.

Archivio Amazon S3

Per utilizzare un bucket Amazon Simple Storage Service come repository:

  1. Crea un bucket Amazon S3 pubblico o privato. Per ulteriori informazioni, consulta la documentazione di Amazon S3.

  2. AWS OpsWorks Affinché Stacks possa accedere ai bucket privati, devi essere un utente con almeno diritti di sola lettura sul bucket Amazon S3 e avrai bisogno dell'ID della chiave di accesso e della chiave di accesso segreta. Per ulteriori informazioni, consulta la documentazione di AWS Identity and Access Management.

  3. Inserire il codice e i file associati in una cartella e archiviare la cartella in un archivio compresso (zip, gzip, bzip2, Java WAR o tarball).

    Nota

    AWS OpsWorks Stacks non supporta archivi tar non compressi.

  4. Carica il file di archivio nel bucket Amazon S3 e registra l'URL.

  5. Per specificare il repository nella console AWS OpsWorks Stacks, imposta il tipo di repository su S3 Archive e inserisci l'URL dell'archivio. Per un archivio privato, è necessario fornire anche l'ID di una chiave di accesso AWS e la chiave di accesso segreta la cui policy concede le autorizzazioni per accedere al bucket. Lasciare vuote queste impostazioni per gli archivi pubblici.

Archivio Git

Un repository Git fornisce il controllo del codice sorgente e il controllo delle versioni. AWS OpsWorks Stacks supporta siti di repository ospitati pubblicamente come GitHubBitbucket e server Git ospitati privatamente. Sia per le app che per i moduli Git secondari, il formato utilizzato per specificare l'URL dell'archivio in Application Source (Origine applicazione) dipende se l'archivio è pubblico o privato:

Archivio pubblico: utilizza i protocolli di sola lettura HTTPS o Git. Ad esempio, Nozioni di base sugli stack Linux Chef 11 utilizza un GitHub archivio pubblico a cui è possibile accedere tramite uno dei seguenti formati di URL:

  • Protocollo Git di sola lettura: git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

  • HTTPS: https://github.com/amazonwebservices/opsworks-demo-php-simple-app.git

Archivio privato: utilizza il formato di lettura/scrittura SSH mostrato in questi esempi:

  • Archivi Github: git@github.com:project/repository.

  • Archivi in un server Git: user@server:project/repository

Se selezioni Git in Source Control (Controllo origine) vengono visualizzate altre due impostazioni opzionali:

Repository SSH key (Chiave SSH archivio)

Devi specificare una chiave SSH di distribuzione per accedere agli archivi Git privati. Questo campo richiede la chiave privata; la chiave pubblica è assegnata al repository Git. Per i moduli secondari Git, la chiave specificata deve avere accesso a tali moduli secondari. Per ulteriori informazioni, consulta Utilizzo di chiavi SSH di repository Git.

Importante

La chiave SSH deploy non può richiedere una password; AWS OpsWorks Stacks non ha modo di passarla.

Branch/Revision (Ramo/Versione)

Se il repository ha più rami, AWS OpsWorks Stacks scarica il ramo principale per impostazione predefinita. Per specificare un determinato ramo, immetti il nome del ramo, hash SHA1, o il nome del tag. Per specificare un determinato commit, immetti l'identificatore di commit completo a 40 cifre esadecimali.

Altri archivi

Se gli archivi standard non soddisfano i requisiti, puoi usare altri archivi, ad esempio Bazaar. Tuttavia, AWS OpsWorks Stacks non distribuisce automaticamente le app da tali repository. Devi implementare le ricette personalizzati per gestire il processo di distribuzione e assegnarle agli eventi Deploy (Distribuzione) dei livelli appropriati. Per un esempio di come implementare le ricette di ditribuzione (Distribuzione), consulta Ricette di ditribuzione.

Origini dati

Questa sezione collega un database all'app. Sono disponibili le seguenti opzioni:

  • RDS: collega uno dei livelli di servizio Amazon RDS dello stack.

  • Nessuno: non collegare un server di database.

Se selezioni RDS, devi specificare le seguenti informazioni.

Istanza di database

L'elenco include tutti i livelli di servizio Amazon RDS. Puoi anche selezionare una delle seguenti opzioni:

(Obbligatorio) Specificare il server di database da collegare all'app. Il contenuto dell'elenco dipende dall'origine dati.

  • RDS: un elenco dei livelli di servizio Amazon RDS dello stack.

Nome del database

(Opzionale) Specificare un nome di database.

  • Livello Amazon RDS: inserisci il nome del database che hai specificato per l'istanza Amazon RDS.

    Puoi ottenere il nome del database dalla console Amazon RDS.

Quando distribuisci un'app con un database collegato, AWS OpsWorks Stacks aggiunge la connessione dell'istanza di database agli attributi dell'app. deploy

Puoi scrivere una ricetta personalizzata per recuperare le informazioni dagli attributi deploy e inserirle in un file a cui l'applicazione può accedere. Questo è l'unico modo per fornire informazioni sulla connessione al database all'applicazione di tipo Other (Altro).

Per ulteriori informazioni su come gestire le connessioni al database, consulta Connessione a un database.

Per scollegare un server di database da un'app, modifica la configurazione dell'app per specificare un server di database diverso oppure nessun server.

Variabili di ambiente

Per ogni app puoi specificare un set di variabili di ambiente specifiche per l'app. Ad esempio, se disponi di due applicazioni, le variabili di ambiente definite per la prima app non sono disponibili nella seconda app e viceversa. Puoi inoltre definire la stessa variabile di ambiente per più app e assegnarle un valore diverso per ogni applicazione.

Nota

Non c'è un limite specifico al numero di variabili di ambiente. Tuttavia, la dimensione della struttura dati associata, che include i nomi, i valori e i valori dei flag protetti delle variabili, non può superare i 20 KB. Questo limite deve essere tale da poter far fronte la maggior parte, se non tutti i casi d'uso. Il superamento di tale limite potrebbe generare un errore del servizio (console) o un'eccezione (API) accompagnata dal messaggio "Environment: is too large (maximum is 20KB)" ("Variabile di ambiente troppo grande (massimo: 10 KB)").

AWS OpsWorks Stacks memorizza le variabili come attributi negli attributi dell'app. deploy Puoi impostare le ricette personalizzati in modo che recuperino tali valori utilizzando la sintassi di nodo standard di Chef. Per esempi di come accedere alle variabili di ambiente di un'app, consulta Utilizzo delle variabili di ambiente .

Chiave

Nome della variabile. Può contenere fino a 64 lettere maiuscole e minuscole, numeri e caratteri di sottolineatura (_), ma deve iniziare con una lettera o un carattere di sottolineatura.

Valore

Valore della variabile. Può contenere fino a 256 caratteri, che devono essere tutti stampabili.

Protected value (Valore protetto)

Indica se il valore è protetto. Questa impostazione consente di nascondere le informazioni sensibili, ad esempio le password. Se imposti Protected value (Valore protetto) per una variabile, dopo aver creato l'app:

  • Nella pagina dei dettagli dell'app viene visualizzato solo il nome della variabile e non il valore.

  • Se disponi dell'autorizzazione per modificare l'app, puoi fare clic su Update value (Aggiorna valore) per specificare un nuovo valore, ma non puoi visualizzare o modificare il valore precedente.

Nota

I log di distribuzione Chef talvolta possono includere variabili di ambiente. Questo significa che nella console possono essere visualizzate variabili protette. Per evitare che le variabili protette vengano visualizzate nella console, ti consigliamo di utilizzare i bucket Amazon S3 come storage per le variabili protette che non desideri vengano visualizzate nella console. Un esempio di come utilizzare un bucket S3 a questo scopo è disponibile in Utilizzo di un bucket Amazon S3 in questa guida.

Impostazioni relative a SSL e dominio

Per il tipo di app Altro, AWS OpsWorks Stacks aggiunge le impostazioni agli attributi dell'app. deploy La ricette possono recuperare i dati da questi attributi e configurare il server in base alle esigenze.

Impostazioni relative al dominio

Questa sezione include un campo opzionale Add Domains (Aggiungi domini) per specificare i domini. Per ulteriori informazioni, consulta Utilizzo di domini personalizzati.

Impostazioni SSL

Questa sezione include un pulsante di alternanza SSL Support (Supporto SSL) che puoi utilizzare per abilitare o disabilitare il protocollo SSL. Se fai clic su Yes (Sì), dovrai fornire le informazioni sul certificato SSL. Per ulteriori informazioni, consulta Uso di SSL.