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à.
Attiva un'estensione pubblica di terze parti nel tuo account
L'argomento seguente mostra come attivare un'estensione pubblica di terze parti nel tuo account, rendendola utilizzabile nell'account e nella regione in cui è stata attivata.
Nota
Prima di continuare, conferma di aver creato quella IAMRuolo che utilizzerai con questa estensione.
Attiva un'estensione pubblica (console)
Segui i passaggi indicati in questa sezione per utilizzare la console per:
-
Attiva un'estensione pubblica di terze parti
-
Specificate ulteriori dati di configurazione dell'estensione per il vostro account
Per attivare un'estensione pubblica da utilizzare nel tuo account
Accedi AWS Management Console e apri la AWS CloudFormation console all'indirizzo https://console.aws.amazon.com/cloudformazione.
-
Nella barra di navigazione nella parte superiore dello schermo, scegli il tuo. Regione AWS
-
Dal pannello di navigazione, sotto CloudFormationRegistro, scegli Estensioni pubbliche.
-
Usa il filtro per scegliere il tipo di estensione e scegli Terze parti. (Le estensioni pubblicate da AWS sono attivate per impostazione predefinita).
-
Scegli l'estensione, quindi scegli Attiva.
Se sono disponibili più versioni di un'estensione, puoi utilizzare il menu Versione per scegliere la versione dell'estensione che desideri attivare. Il valore predefinito è la versione più recente.
-
Per attivare l'estensione utilizzando un alias del tipo di estensione:
-
Scegliete Ignora impostazioni predefinite
-
Immetti l'alias del tipo di estensione che desideri utilizzare con questa estensione. L'alias deve seguire il formato consigliato per il tipo di estensione.
Per ulteriori informazioni, consulta Usa gli alias per fare riferimento alle estensioni.
-
-
Se stai abilitando una risorsa privata, puoi specificare il IAM ruolo CloudFormation da assumere quando richiami l'estensione.
-
In Logging config (Configurazione registrazione), specifica le informazioni di configurazione della registrazione per un'estensione, se lo desideri. Ad esempio:
{ "logRoleArn": "arn:aws:iam::
account
:role/rolename
", "logGroupName": "log-group-name
" }Le informazioni di configurazione della registrazione non sono obbligatorie, ma sono consigliate ai fini del debug. Per utilizzare la configurazione di registrazione con Hooks, aggiungi la stessa politica di fiducia del ruolo di esecuzione specificato, in modo che il ruolo di registro possa scrivere i log nel tuo gruppo di log.
logRoleArne i nomi delle logGroupNamechiavi fanno distinzione tra maiuscole e minuscole.
-
In Controllo delle versioni, Aggiornamenti automatici, scegli come ricevere gli aggiornamenti.
-
On (Attivato): effettua automaticamente l'aggiornamento all'ultima versione secondaria. Le versioni principali vengono aggiornate manualmente.
-
Off (Disattivato): non effettua mai automaticamente l'aggiornamento all'ultima versione. Tutte le versioni vengono aggiornate manualmente.
Per ulteriori informazioni, consulta Utilizza automaticamente nuove versioni delle estensioni.
-
Se l'estensione richiede una configurazione aggiuntiva, hai la possibilità di specificare i dati di configurazione ora o dopo l'attivazione dell'estensione.
Importante
Se l'estensione che stai attivando è un Hook, questo passaggio è obbligatorio. È necessario specificare ENABLED
per la proprietà HookInvocationStatus
. Questa operazione abilita le proprietà dell'Hook definite nella properties
sezione dello schema di Hook. Per ulteriori informazioni, vedere il riferimento alla sintassi dello schema di configurazione di Hook nella Guida per l'utente di AWS CloudFormation Hooks.
Per specificare i dati di configurazione
-
Per Configurazione, scegli Configura ora, quindi scegli Attiva estensione.
CloudFormation visualizza la pagina Configura estensione. Per visualizzare lo schema di configurazione corrente per l'estensione, assicurati che View configuration schema (Visualizza schema di configurazione) sia attivato.
-
Nella casella di JSON testo Configurazione, inserisci una JSON stringa che rappresenta i dati di configurazione che desideri specificare per questa estensione. I dati JSON specificati devono essere convalidati rispetto allo schema di configurazione dell'estensione.
-
Scegli Configura estensione.
Se preferisci configurare l'estensione dopo l'attivazione, puoi saltare questo passaggio e fornire i dati di configurazione in un secondo momento.
-
Per Configurazione, scegli Configura in seguito, quindi scegli Attiva estensione.
-
Dopo l'attivazione dell'estensione, puoi configurarla accedendo all'estensione dalla pagina delle estensioni attivate e fornendo i dati di configurazione.
Attiva un'estensione pubblica ()AWS CLI
Segui la procedura descritta in questa sezione per AWS CLI utilizzare:
-
Attivare un'estensione pubblica di terze parti
-
Specificate ulteriori dati di configurazione dell'estensione per il vostro account
Attiva gli Hooks pubblici
Attivando Hooks nel tuo account, autorizzi un Hook a utilizzare le autorizzazioni definite dal tuo. Account AWS CloudFormation rimuove le autorizzazioni non richieste prima di passare le autorizzazioni all'Hook. CloudFormationconsiglia ai clienti o agli utenti di Hook di rivedere le autorizzazioni di Hook e di essere consapevoli delle autorizzazioni a cui sono consentiti gli Hook prima di attivare gli Hook nel proprio account.
Per attivare un Hook pubblico da utilizzare nel tuo account ()AWS CLI
-
Scarica il file ARN per il tuo Hook e salvalo. Puoi ottenere il simbolo ARN di un Hook usando AWS Management Console o AWS CLI. Per ulteriori informazioni, consulta Visualizza le estensioni disponibili e attivate nel CloudFormation registro.
export HOOK_TYPE_ARN="
arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/
" -
Utilizzo dell'set-type-configurationcomando per specificare i dati di configurazione. Il file JSON che passi
--configuration
deve essere convalidato rispetto allo schema di configurazione di Hook. Per attivare l'Hook per tutte le operazioni sullo stack, è necessario impostare laHookInvocationStatus
proprietà suENABLED
nellaHookConfiguration
sezione.aws cloudformation set-type-configuration \ --configuration
"{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}"
\ --type-arn $HOOK_TYPE_ARN
--regionus-west-2
Per ulteriori informazioni sulle opzioni di
HookConfiguration
configurazione, vedere il riferimento alla sintassi dello schema di configurazione di Hook nella Guida per l'utente di AWS CloudFormation Hooks.
Attiva moduli pubblici e tipi di risorse
Per attivare un'estensione pubblica da utilizzare nel tuo account (AWS CLI)
-
Utilizza
activate-type
per attivare l'estensione e specificare se aggiornare automaticamente l'estensione ogni volta che viene pubblicata una nuova versione secondaria.L'esempio seguente specifica l'Amazon Resource Name (ARN) pubblico di un'estensione pubblica da attivare per questo account. Inoltre, specifica che CloudFormation aggiorna l'estensione ogni volta che viene pubblicata una nuova versione secondaria.
aws cloudformation activate-type \ --public-type-arn
public_extension_ARN
\ --auto-updatetrue
--regionus-west-2
Questo comando restituisce una ARN delle estensioni attivate.
{ "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example" }
Aggiorna la versione di un'estensione pubblica (AWS CLI)
Utilizzare activate-typeper attivare nuovamente l'estensione.
Utilizzate l'--version-bump
opzione per specificare se aggiornare l'estensione alla MAJOR
versione più recente o alla versione più recenteMINOR
.
aws cloudformation activate-type --type
RESOURCE
\ --type-nameExample::Test::1234567890abcdef0
\ --type-name-aliasExample::Test::Alias
\ --version-bumpMAJOR
--regionus-west-2