Questa è la AWS CDK v2 Developer Guide. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.
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à.
cdk flags
Visualizza e modifica le configurazioni dei feature flag per la CLI CDK.
I flag di funzionalità controllano il comportamento della CLI CDK e possono essere utilizzati per abilitare o disabilitare funzionalità specifiche. Utilizzate il cdk flags comando per visualizzare le configurazioni correnti dei feature flag e modificarle secondo necessità.
avvertimento
Il cdk flags comando è in fase di sviluppo per il AWS CDK. Le funzionalità correnti di questo comando sono considerate pronte per la produzione e sicure da usare. Tuttavia, l'ambito di questo comando e le relative funzionalità sono soggetti a modifiche. Pertanto, è necessario attivare il consenso fornendo la unstable=flags possibilità di utilizzare questo comando.
Utilizzo
$ cdk flags <arguments> <options>
Argomenti
- NOME DELLA BANDIERA
-
Il nome del flag di funzionalità specifico che si desidera visualizzare o modificare.
Tipo: stringa
Required: No
Opzioni
Per un elenco di opzioni globali che funzionano con tutti i comandi CDK CLI, vedete Opzioni globali.
-
--set <BOOLEAN> -
Modifica la configurazione di un flag di funzionalità.
-
--all <BOOLEAN> -
Modifica o visualizza tutti i flag di funzionalità.
-
--recommended <BOOLEAN> -
Cambia i flag negli stati consigliati.
-
--default <BOOLEAN> -
Cambia le bandiere in stati predefiniti.
-
--unconfigured <BOOLEAN> -
Modifica i flag delle funzionalità non configurati.
-
--value <STRING> -
Il valore su cui impostare la configurazione dei feature flag.
requireARG: true
-
--safe <BOOLEAN> -
Abilita tutte le funzionalità che non influiscono sull'applicazione.
-
--interactive, -i <BOOLEAN> -
Opzione interattiva per il comando flags.
Esempi
Visualizza le configurazioni dei flag delle funzionalità
Esegui cdk flags per visualizzare un rapporto sulle configurazioni dei tuoi feature flag che differiscono dai nostri stati consigliati. I flag non configurati sono etichettati con <unset> per indicare che al momento non hanno alcun valore. Le bandiere vengono visualizzate nel seguente ordine:
-
Bandiere impostate su un valore che non corrisponde al nostro valore consigliato
-
Bandiere che non hai configurato
$ cdk flags --unstable=flags Feature Flag Recommended User * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
Puoi anche correre cdk flags --all per visualizzare un report di tutti i flag di funzionalità nel seguente ordine:
-
Bandiere impostate su un valore che corrisponde al nostro valore consigliato
-
Bandiere impostate su un valore che non corrisponde al nostro valore consigliato
-
Bandiere che non hai configurato
$ cdk flags --unstable=flags --all Feature Flag Recommended User @aws-cdk/... true true * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset>
Modifica i valori dei flag delle funzionalità
Per modificare i flag delle funzionalità in modo interattivo, esegui cdk flags --interactive (ocdk flags -i) per visualizzare un elenco di opzioni di menu.
Per modificare ogni flag di funzionalità secondo il valore consigliato, esegui. cdk flags --set --recommended --all Questo comando mantiene la configurazione dei feature flag up-to-date con le ultime configurazioni dei feature flag di CDK. Tieni presente che l'esecuzione di questo comando può potenzialmente sovrascrivere i valori configurati esistenti.
$ cdk flags --unstable=flags --set --recommended --all Feature Flag Recommended Value User Value * @aws-cdk/... true false * @aws-cdk/... true false * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
Se vuoi preservare lo stato dei flag configurati esistenti, esegui. cdk flags --set --recommended --unconfigured Questa opzione modifica solo i flag delle funzionalità non configurate in base ai valori consigliati.
$ cdk flags --unstable=flags --set --recommended --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Resources [~] AWS::S3::Bucket MyBucket └─ [~] Properties └─ [~] Encryption ├─ [-] None └─ [+] ServerSideEncryptionConfiguration: - ... ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
Se vuoi assicurarti che i flag di funzionalità non configurati non interferiscano con l'applicazione, esegui il cdk flags --set --default --unconfigured comando per riportare i flag non configurati ai valori predefiniti. Ad esempio, se non è configurato, @aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021 viene visualizzata una notifica dopo l'esecuzione. cdk synth Tuttavia, se imposti il flag allo stato predefinito (false), verrà configurato, disattivato e non avrà alcun impatto sull'applicazione.
$ cdk flags --unstable=flags --set --default --unconfigured Feature Flag Recommended Value User Value * @aws-cdk/... true <unset> * @aws-cdk/... true <unset> Synthesizing... Do you want to accept these changes? (y/n) y Resynthesizing...
Ispeziona le bandiere di funzionalità specifiche
Visualizza ulteriori informazioni su una bandiera
Oltre a eseguire cdk flags e cdk flags --all visualizzare la configurazione del flag di funzionalità, potete anche cdk flags "FLAGNAME" ispezionare un flag di funzionalità specifico e scoprire a cosa serve il flag. Questo può essere utile nei casi in cui desideri comprendere un particolare flag e il suo impatto sull'applicazione.
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default. Recommended Value: true User Value: true
Filtra i flag per sottostringa
Puoi anche eseguire l'operazione cdk flags substring per visualizzare tutti i flag di funzionalità corrispondenti. Se esiste un solo flag di funzionalità che corrisponde a quella sottostringa, vengono visualizzati dettagli specifici.
$ cdk flags --unstable=flags ebs @aws-cdk/aws-ec2:ebsDefaultGp3Volume Description: When enabled, the default volume type of the EBS volume will be GP3 Recommended Value: true User Value: true
Se più flag corrispondono alla sottostringa, tutti i flag corrispondenti vengono visualizzati in una tabella. Se si inseriscono più sottostringhe, vengono restituiti tutti i flag corrispondenti che contengono una qualsiasi delle sottostringhe.
$ cdk flags --unstable=flags s3 lambda Feature Flag Recommended User * @aws-cdk/s3... true false * @aws-cdk/lambda... true false * @aws-cdk/lambda... true <unset>
Modifica un flag specifico
Se devi modificare il valore di un flag e vuoi assicurarti di impostarlo su uno stato corretto e supportato, eseguicdk flags --set "FLAGNAME" --value="state".
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true" Synthesizing... Resources [~] AWS::CloudFront::Distribution MyDistribution └─ [~] Properties └─ [~] DefaultSecurityPolicy ├─ [-] TLSv1.0 └─ [+] TLSv1.2_2021 - ... Number of stacks with differences: 2 Do you want to accept these changes? (y/n) y Resynthesizing...
