In diesem Blogbeitrag erweitern wir unser Powershell Script, welches wir im Artikel „AWS Backup Notifications – Einfach und schnell“ erstellt haben, um einen Backup Plan und einer dazugehörigen Selection.
Durch die Selection definieren wir, wie und auf welche Ressourcen der Backup Plan zutrifft.
Eine kurze Übersicht, was wir bereits in unserem Script aufgebaut haben:
- SNS Topic (mit Attributes)
- Protocol Type und Notifications
- Optional: Backup Vault
- SNS Subscricption
Was wir jetzt noch für einen Backup Plan benötigen, sind folgende Punkte:
- Das bestehende Skript um neue Parameter erweitern
- Erstellung des Backup Plan
- Zuweisen einer IAM Rolle
- Erstellen der Selection
Neue Parameter
Zunächst brauchen wir neue Parameter, auf die wir uns im Anschluss beziehen können.
Für den Backup Plan brauchen wir:
# PARAMETER BACKUP PLAN
$BackupPlanName = “BESTBACKUPPLAN”
$BackupRuleName = “BESTBACKUPRULE”
$BackupPlanMinutes = “0”
$BackupPlanHours = “1”
$BackupPlanDayOfMonth = “?”
$BackupPlanMonth = “*”
$BackupPlanDayOfWeek = “*”
$BackupPlanYear = “*”
$BackupPlanStart = “120”
$BackupPlanDelete = “30”
$BackupPlanCompletion = “10080”
Hier geben wir neben dem Namen für den Backup Plan und der Rule an, wann ein Backup durchgeführt werden soll und wie lange dieses Backup aufbewahrt wird.
Die Werte für diese Parameter werden mit Cron-Zeichen angegeben. Dadurch können die zeitlichen Abläufe individuell angepasst werden.
Cron-Zeichen:
Feld
Werte
Platzhalter
Minuten
0-59
, – * /
Stunden
0-23
, – * /
Tag des Monats
1-31
, – * ? / L W
Monat
1-12 oder JAN-DEC
, – * /
Wochentag
1-7 oder SUN-SAT
, – * ? L #
Quelle: (Planen von Ausdrücken für Regeln – Amazon CloudWatch-Ereignisse)
Da die Platzhalter auf den ersten Blick eventuell nicht allzu aussagekräftig sind, hier eine kleine Erläuterung:
Platzhalter
Beispiel
Erklärung
–
7L: letzter Samstag des Monats
#
DayOfWeek: „2#3“
DayOfWeek: der dritte (3) Montag (2) des Monats
Der Cron-Ausdruck in unserem Beispiel lautet: cron(0 1 ? * * *)
$BackupPlanMinutes = “0”
$BackupPlanHours = “1”
$BackupPlanDayOfMonth = “?”
$BackupPlanMonth = “*”
$BackupPlanDayOfWeek = “*”
$BackupPlanYear = “*”
Dadurch wird zu jeder vollen Stunde, ohne Einschränkungen auf Tag oder Monat, ein Zeitfenster für die Durchführung des Backups erstellt.
Mit dem Wert „BackupPlanStart“ geben wir in Minuten an, wann das Backup spätestens innerhalb des Zeitfensters gestartet werden soll. Ansonsten wird der Auftrag für das Backup nicht ausgeführt.
Standardmäßig haben Backups sieben Tage Zeit, bis sie nach erfolgreichem Start fertig sein müssen. Ansonsten werden sie verworfen. Mit „BackupPlanCompletion“ kann aber auch ein anderer Zeitraum angegeben werden.
Um die Ressourcen für einen Backup Plan zu kennzeichnen, benötigen wir noch eine Selection.
In einer Selection (es können mehrere für jeden Plan erstellt werden) können Ressource ID’s direkt hinterlegt werden.
Der elegantere Weg ist jedoch, mit Hilfe von Tags, eine Ressource dem Plan hinzuzufügen.
Dafür benötigen wir drei weitere Parameter:
# PARAMETER BACKUP
SELECTION
$BackupSelectionName = “BESTSELECTION”
$BackupConditionKey = “BESTTAG”
$BackupConditionValue = “BESTVALUE”
BESTTAG ist in dem Beispiel der Key Name, den wir später unserer Ressource hinzufügen. Wenn die Ressource zusätzlich den Value BESTVALUE besitzt, wird sie für den Backup Plan ausgewählt.
Backup Plan und Selection
Mit den neu gesetzten Parametern können wir nun den Backup Plan erstellen.
# BACKUP PLAN JSON
$JSONPLAN = @”
{
“BackupPlanName”: “$BackupPlanName“,
“Rules”: [
{
“RuleName”: “$BackupRuleName“,
“ScheduleExpression”: “cron($BackupPlanMinutes $BackupPlanHours $BackupPlanDayOfMonth $BackupPlanMonth $BackupPlanDayOfWeek $BackupPlanYear)”,
“StartWindowMinutes”: $BackupPlanStart,
“TargetBackupVaultName”: “$BackupVaultName“,
“CompletionWindowMinutes”: $BackupPlanCompletion,
“Lifecycle”: {
“DeleteAfterDays”: $BackupPlanDelete
}
}
]
}
“@
$JSONPLAN | Out-File -Encoding ascii -file BackupPlan.json
Mit diesem Befehl wird ein JSON File (unter dem derzeitigen Pfad) erstellt, in dem sich unsere oben verwendeten Parameter wiederfinden. Dies ist nötig, damit wir im Anschluss die ID des Backup Plans als neue Variable speichern können.
#BACKUP PLAN ID
$BackupPlanId = (aws backup create-backup-plan —backup-plan file://BackupPlan.json | ConvertFrom-Json).BackupPlanId
Da wir nun den Backup Plan in unserer AWS Umgebung erstellt und die dazugehörige ID als Variable gespeichert haben, können wir eine Selection hinzufügen.
Zunächst benötigen wir allerdings noch eine IAM Rolle, die wir für unsere Selection verwenden wollen.
# BACKUP IAM ROLE
$IAMBackupRole = $IAMRoleList -match “AWSBackupDefaultServiceRole” -split ‘”‘ -match “arn:aws:iam”
Wir nutzen hier einfach die vorgefertigte Rolle für Backups von AWS.
Wie bei dem Backup Plan, erstellen wir uns zunächst ein JSON File mit dem Inhalt der Selection. Dazu gehören der Selection Name und die IAM Rolle sowie der Key Name für den Tag und dessen Inhalt (Value).
# BACKUP SELECTION JSON
$JSONSELECTION = @”
{
“SelectionName”: “$BackupSelectionName“,
“IamRoleArn”: “$IAMBackupRole“,
“Resources”: [],
“ListOfTags”: [
{
“ConditionType”: “STRINGEQUALS”,
“ConditionKey”: “$BackupConditionKey“,
“ConditionValue”: “$BackupConditionValue“
}
]
}
“@
$JSONSELECTION | Out-File -Encoding ascii -file BackupSelection.json
Zu guter Letzt bringen wir die ID des Backup Plans und das JSON File für die Selection zusammen.
# BACKUP SELECTION
aws backup create-backup-selection —backup-plan-id $BackupPlanId —backup-selection file://BackupSelection.json
Unser PowerShell Script ist jetzt fertig!
Wir können nun neben SNS Topic, SNS Notification und Backup Vault auch einen Backup Plan mit einer Selection mit nur einem Klick erstellen.
Das Einzige was jetzt noch fehlt, ist der Ressource, die wir dem Backup Plan hinzufügen wollen, den Tag (BESTTAG), sowie das Value (BESTVALUE), aus der dazugehörigen Selection zuzuweisen.
Fazit
Zugegeben, manche Dinge sind nicht sehr intuitiv, was AWS in Kombination mit PowerShell angeht. Doch mit ein paar kleinen Tricks, kann man so gut wie alles in ein Script packen und automatisieren.
Ich hoffe, dieser Blog (und auch der erste Teil: AWS Backup Notifications) war hilfreich und motiviert den ein oder anderen, mehr AWS Befehle in PowerShell zu nutzen.
Von Alex
