AWSPremiumSupport-ChangeInstanceTypeIntelToAMD - AWS Systems Manager Riferimento al runbook di automazione

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à.

AWSPremiumSupport-ChangeInstanceTypeIntelToAMD

Descrizione

Il AWSPremiumSupport-ChangeInstanceTypeIntelToAMD runbook automatizza le migrazioni dalle istanze Amazon Elastic Compute Cloud (Amazon EC2) con tecnologia Intel ai tipi di istanze equivalenti basati su AMD. Questo runbook supporta istanze generiche (M), espandibili generiche (T), ottimizzate per l'elaborazione (C) e ottimizzate per la memoria (R) basate sul sistema Nitro. Questo runbook può essere utilizzato su istanze che non sono gestite da Systems Manager.

Per ridurre il rischio potenziale di perdita e downtime dei dati, il runbook verifica il comportamento di arresto dell'istanza, se l'istanza appartiene a un gruppo Amazon EC2 Auto Scaling, lo stato dell'istanza e se il tipo di istanza equivalente con tecnologia AMD è disponibile nella stessa zona di disponibilità. Per impostazione predefinita, questo runbook non modificherà il tipo di istanza se i volumi dell'archivio delle istanze sono collegati o se l'istanza fa parte di uno AWS CloudFormation stack. Se desideri modificare questo comportamento, specifica yes uno dei AllowCloudFormationInstances parametri AllowInstanceStoreInstances and.

Importante

L'accesso ai AWSPremiumSupport-* runbook richiede un abbonamento Enterprise o Business Support. Per ulteriori informazioni, consulta Confronta AWS Support i piani.

Considerazioni

  • Ti consigliamo di eseguire il backup dell'istanza prima di utilizzare questo runbook.

  • La modifica del tipo di istanza richiede che il runbook interrompa l'istanza. Quando un'istanza viene interrotta, tutti i dati memorizzati nella RAM o nei volumi dell'archivio delle istanze vengono persi e l'indirizzo IPv4 pubblico automatico viene rilasciato. Per ulteriori informazioni, consulta Arrestare e avviare un'istanza.

  • Se non specificate un valore per il TargetInstanceType parametro, il runbook tenta di identificare l'istanza AMD equivalente in termini di CPU virtuali e memoria all'interno della stessa famiglia di istanze. Il runbook termina se non è in grado di identificare un tipo di istanza AMD equivalente.

  • Utilizzando l'DryRunopzione, è possibile acquisire il tipo di istanza AMD equivalente e convalidare i requisiti senza modificare effettivamente il tipo di istanza.

Esegui questa automazione (console)

Tipo di documento

Automazione di

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

  • AutomationAssumeRole

    Tipo: String

    Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

  • Accettare

    Tipo: String

    Descrizione: (Obbligatorio) Entra yes per confermare che l'istanza di destinazione verrà interrotta se è in esecuzione.

  • InstanceId

    Tipo: String

    Descrizione: (obbligatorio) L'ID dell'istanza Amazon EC2 di cui desideri modificare il tipo.

  • TargetInstanceType

    Tipo: String

    Predefinito: automatico

    Descrizione: (Facoltativo) Il tipo di istanza AMD in cui desideri modificare l'istanza. Il automatic valore predefinito utilizza il tipo di istanza equivalente in termini di CPU e memoria virtuali. Ad esempio, un m5.large verrebbe modificato in m5a.large.

  • AllowInstanceStoreInstances

    Tipo: String

    Valori validi: no | sì

    Impostazione predefinita: no

    Descrizione: (Facoltativo) Se si specificayes, il runbook viene eseguito su istanze a cui sono collegati i volumi dell'archivio delle istanze.

  • AllowCloudFormationInstances

    Tipo: String

    Valori validi: no | sì

    Impostazione predefinita: no

    Descrizione: (Facoltativo) Se impostato suyes, il runbook viene eseguito su istanze che fanno parte di uno AWS CloudFormation stack.

  • AllowCrossGeneration

    Tipo: String

    Valori validi: no | sì

    Impostazione predefinita: no

    Descrizione: (Facoltativo) Se impostato suyes, il runbook tenta di trovare il tipo di istanza AMD equivalente più recente all'interno della stessa famiglia di istanze.

  • DryRun

    Tipo: String

    Valori validi: no | sì

    Impostazione predefinita: no

    Descrizione: (Facoltativo) Se impostato suyes, il runbook restituisce il tipo di istanza AMD equivalente e convalida i requisiti di migrazione senza apportare modifiche al tipo di istanza.

  • SleepWait

    Tipo: String

    Predefinito: PT3S

    Descrizione: (Facoltativo) Il tempo che il runbook deve attendere prima di avviare una nuova automazione. Il valore fornito per questo parametro deve corrispondere allo standard ISO 8601. Per ulteriori informazioni sulla creazione di stringhe ISO 8601, vedere Formattazione delle stringhe di data e ora per Systems Manager.

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

  • ssm:StartAutomationExecution

  • ec2:GetInstanceTypesFromInstanceRequirements

  • ec2:DescribeInstanceAttribute

  • ec2:DescribeInstances

  • ec2:DescribeInstanceStatus

  • ec2:DescribeInstanceTypeOfferings

  • ec2:DescribeInstanceTypes

  • ec2:DescribeTags

  • ec2:ModifyInstanceAttribute

  • ec2:StartInstances

  • ec2:StopInstances

Fasi del documento

  1. aws:assertAwsResourceProperty: conferma che lo stato dell'istanza Amazon EC2 di destinazione èrunning, pendingstopped, ostopping. Altrimenti, l'automazione termina.

  2. aws:executeAwsApi: raccoglie le proprietà dall'istanza Amazon EC2 di destinazione.

  3. aws:branch: ramifica l'automazione in base allo stato dell'istanza Amazon EC2.

    1. In caso contrario stoppedstopping, l'automazione viene eseguita aws:waitForAwsResourceProperty fino all'arresto completo dell'istanza Amazon EC2.

    2. In caso running pending affermativo, l'automazione viene eseguita aws:waitForAwsResourceProperty fino a quando l'istanza Amazon EC2 non supera i controlli di stato.

  4. aws:assertAwsResourceProperty: conferma che l'istanza Amazon EC2 non fa parte di un gruppo Auto Scaling controllando se il aws:autoscaling:groupName tag è applicato.

  5. aws:executeAwsApi: raccoglie le proprietà del tipo di istanza corrente per trovare il tipo di istanza AMD equivalente.

  6. aws:assertAwsResourceProperty: conferma che un codice Marketplace AWS prodotto non è associato all'istanza Amazon EC2. Alcuni prodotti non sono disponibili per tutti i tipi di istanze.

  7. aws:branch: ramifica l'automazione a seconda che tu voglia che l'automazione controlli se l'istanza Amazon EC2 fa parte di uno stack AWS CloudFormation

    1. Se il aws:cloudformation:stack-name tag viene applicato all'istanza, l'automazione viene eseguita aws:assertAwsResourceProperty per confermare che l'istanza non fa parte di uno AWS CloudFormation stack.

  8. aws:branch: ramifica l'automazione in base al fatto che il tipo di volume principale dell'istanza sia Amazon Elastic Block Store (Amazon EBS).

  9. aws:assertAwsResourceProperty: conferma che il comportamento di chiusura dell'istanza è stop e non lo è. terminate

  10. aws:executeScript: conferma che esiste una sola automazione di questo runbook destinata all'istanza corrente. Se è già in corso un'altra automazione destinata alla stessa istanza, restituisce un errore e termina.

  11. aws:executeAwsApi: restituisce un elenco dei tipi di istanze AMD con la stessa quantità di memoria e vCPU.

  12. aws:executeScript: verifica se il tipo di istanza corrente è supportato e restituisce il tipo di istanza AMD equivalente. Se non c'è un equivalente, l'automazione termina.

  13. aws:executeScript: conferma che il tipo di istanza AMD è disponibile nella stessa zona di disponibilità e verifica le autorizzazioni IAM fornite.

  14. aws:branch: ramifica l'automazione in base al fatto che il valore del DryRun parametro siayes.

  15. aws:branch: verifica se il tipo di istanza originale e quello di destinazione sono gli stessi. Se sono uguali, l'automazione termina.

  16. aws:executeAwsApi: ottiene lo stato corrente dell'istanza.

  17. aws:changeInstanceState: arresta l'istanza Amazon EC2.

  18. aws:changeInstanceState: forza l'arresto dell'istanza se è bloccata nello stato di arresto.

  19. aws:executeAwsApi: modifica il tipo di istanza impostando il tipo di istanza AMD di destinazione.

  20. aws:sleep: attende 3 secondi dopo aver modificato il tipo di istanza per una maggiore coerenza.

  21. aws:branch: ramifica l'automazione in base allo stato dell'istanza precedente. In caso affermativorunning, l'istanza viene avviata.

    1. aws:changeInstanceState: avvia l'istanza Amazon EC2 se era in esecuzione prima di cambiare il tipo di istanza.

    2. aws:waitForAwsResourceProperty: attende che l'istanza Amazon EC2 superi i controlli di stato. Se l'istanza non supera i controlli di stato, viene ripristinata al tipo di istanza originale.

      1. aws:changeInstanceState: arresta l'istanza Amazon EC2 prima di cambiarla nel tipo di istanza originale.

      2. aws:changeInstanceState: forza l'arresto dell'istanza Amazon EC2 prima di cambiarla nel tipo di istanza originale nel caso in cui rimanga bloccata in uno stato di arresto.

      3. aws:executeAwsApi: modifica il tipo originale dell'istanza Amazon EC2.

      4. aws:sleep: attende 3 secondi dopo la modifica del tipo di istanza per una maggiore coerenza.

      5. aws:changeInstanceState: avvia l'istanza Amazon EC2 se era in esecuzione prima di cambiare il tipo di istanza.

      6. aws:waitForAwsResourceProperty: attende che l'istanza Amazon EC2 superi i controlli di stato.

  22. aws:sleep: Attende prima di terminare il runbook.