AWSPremiumSupport-ChangeInstanceTypeIntelToAMD - AWS Systems Manager Riferimento all'Automation Runbook

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 da istanze Amazon Elastic Compute Cloud (Amazon EC2) con tecnologia Intel ai tipi di istanze equivalenti con tecnologia AMD. Questo runbook supporta istanze generiche (M), burstable generiche (T), ottimizzate per il calcolo (C) e ottimizzate per la memoria (R) basate sul sistema Nitro. Questo runbook può essere utilizzato su istanze non gestite da Systems Manager.

Per ridurre il rischio potenziale di perdita dei dati e tempi di inattività, il runbook verifica il comportamento di arresto dell'istanza, se l'istanza si trova in 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 modifica il tipo di istanza se sono collegati volumi di instance store o se l'istanza fa parte di uno stack. AWS CloudFormation Se desideri modificare questo comportamento, specifica uno yes dei parametri AllowInstanceStoreInstances andAllowCloudFormationInstances.

Importante

L'accesso ai AWSPremiumSupport-* runbook richiede un abbonamento Business + Support, Enterprise Support o Unified Operations. Per ulteriori informazioni, consulta Confronta Supporto AWS 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 arrestata, tutti i dati memorizzati nella RAM o nei volumi dell'Instance Store vengono persi e l' IPv4 indirizzo pubblico automatico viene rilasciato. Per ulteriori informazioni, consulta Arrestare e avviare un'istanza.

  • Se non si specifica un valore per il TargetInstanceType parametro, il runbook tenta di identificare l'istanza AMD equivalente in termini di memoria CPUs e virtuale 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

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.

  • Riconoscere

    Tipo: String

    Descrizione: (Obbligatorio) Inserisci 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 memoria CPUs e virtuale. 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 volumi di Instance Store.

  • 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 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

    Impostazione predefinita: S PT3

    Descrizione: (Facoltativo) Il tempo che il runbook deve attendere prima di iniziare 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, o. stopping In caso contrario, l'automazione termina.

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

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

    1. In caso stopped stopping affermativo, l'automazione viene eseguita aws:waitForAwsResourceProperty fino al completo arresto 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 aws:autoscaling:groupName il 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: suddivide l'automazione a seconda che desideri che l'automazione controlli se l'istanza Amazon EC2 fa parte di uno stack 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 CloudFormation stack.

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

  9. aws:assertAwsResourceProperty: Conferma che il comportamento di chiusura dell'istanza è stop corretto e negativo. 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 v. CPUs

  12. aws:executeScript: verifica se il tipo di istanza corrente è supportato e restituisce il tipo di istanza AMD equivalente. Se non esiste 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: Suddivide l'automazione in base al fatto che il valore del DryRun parametro sia o meno. yes

  15. aws:branch: Verifica se il tipo di istanza originale e quello di destinazione coincidono. 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 nel tipo di istanza AMD di destinazione.

  20. aws:sleep: attende 3 secondi dopo la modifica del tipo di istanza per garantire la coerenza finale.

  21. aws:branch: suddivide l'automazione in base allo stato precedente dell'istanza. 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, torna al tipo di istanza originale.

      1. aws:changeInstanceState: arresta l'istanza Amazon EC2 prima di sostituirla con il tipo di istanza originale.

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

      3. aws:executeAwsApi: modifica l'istanza Amazon EC2 riportandola al tipo originale.

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

      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.