core

Tutte le classi sono in fase di sviluppo attivo e soggette a modifiche o rimozione non compatibili con le versioni precedenti in qualsiasi versione futura. Questi non sono soggetti allaSemantic versioning (Controllo delleModello. Ciò significa che, mentre è possibile utilizzarli, potrebbe essere necessario aggiornare il codice sorgente quando si esegue l'aggiornamento a una versione più recente di questo pacchetto.

La libreria principale include gli elementi di base di AWS Solutions Constructs. Definisce le classi principali che vengono utilizzati nel resto di AWS Solutions Constructs.

Proprietà predefinite per i costrutti CDK AWS

La libreria di base imposta le proprietà predefinite per i costrutti CDK AWS utilizzati dai costrutti di soluzioni AWS.

Ad esempio, il seguente è lo snippet di proprietà predefinite per il costrutto S3 Bucket creato da AWS Solutions Constructs costrutto. Per impostazione predefinita, attiva la crittografia lato server, il controllo delle versioni del bucket, blocca tutti gli accessi pubblici e configura la registrazione degli accessi S3.

{
  encryption: s3.BucketEncryption.S3_MANAGED,
  versioned: true,
  blockPublicAccess: s3.BlockPublicAccess.BLOCK_ALL,
  removalPolicy: RemovalPolicy.RETAIN,
  serverAccessLogsBucket: loggingBucket
}

Sostituisci le proprietà predefinite

Le proprietà predefinite impostate dalla libreria Core possono essere sostituite dalle proprietà fornite dall'utente. Ad esempio, l'utente può sostituire la proprietà Amazon S3 Block Public Access per soddisfare requisiti specifici.

  const stack = new cdk.Stack();

  const props: CloudFrontToS3Props = {
    bucketProps: {
      blockPublicAccess: {
        blockPublicAcls: false,
        blockPublicPolicy: true,
        ignorePublicAcls: false,
        restrictPublicBuckets: true
      }
    }
  };

  new CloudFrontToS3(stack, 'test-cloudfront-s3', props);

  expect(stack).toHaveResource("AWS::S3::Bucket", {
    PublicAccessBlockConfiguration: {
      BlockPublicAcls: false,
      BlockPublicPolicy: true,
      IgnorePublicAcls: false,
      RestrictPublicBuckets: true
    },
  });

Avvisi della sostituzione della proprietà

Quando una proprietà predefinita della libreria Core viene sovrascritta da una proprietà fornita dall'utente, Constructs emette uno o più messaggi di avviso alla console che evidenziano le modifiche. Questi messaggi hanno lo scopo di fornire consapevolezza della situazione all'utente e prevenire sostituzioni involontarie che potrebbero creare rischi per la sicurezza. Questi messaggi verranno visualizzati ogni volta che vengono eseguiti comandi relativi alla distribuzione/compilazione, inclusicdk deploy,cdk synth,npm test, e così via.

Messaggi di esempio:AWS_CONSTRUCTS_WARNING: An override has been provided for the property: BillingMode. Default value: 'PAY_PER_REQUEST'. You provided: 'PROVISIONED'.

Attivazione degli avvisi di override

I messaggi di avviso di sostituzione sono abilitati per impostazione predefinita, ma possono essere attivati/disattivati esplicitamente utilizzando il comandooverrideWarningsEnabledShell variabile.

• Per esplicitamenteDisattivazione disovrascrivere gli avvisi, eseguireexport overrideWarningsEnabled=false: .

• Per esplicitamenteAttivaresovrascrivere gli avvisi, eseguireexport overrideWarningsEnabled=true: .

• Per ripristinare l'impostazione predefinita, eseguireunset overrideWarningsEnabled: .