In diesem Dokument wird beschrieben, wie Sie mithilfe der Befehlszeile des Discovery-Clients des Migrationscenters eine Inventarermittlung in Ihrem Amazon Web Services-Konto (AWS) durchführen.
Mit der mcdc-Befehlszeile können Sie Informationen zu den folgenden Assets in Ihrem AWS-Konto erfassen:
- Amazon Elastic Compute Cloud (EC2)
- Amazon Relational Database Service (RDS)
- Microsoft SQL Server
- MySQL
- PostgreSQL
Die folgenden Dienste sind in der Vorschau verfügbar:
- Amazon CloudFront
- Amazon DynamoDB
- Amazon Elastic Container Service (ECS)
- Amazon Elastic File System (EFS)
- Amazon Elastic Kubernetes Service (EKS)
- Amazon Redshift
- Amazon Route53
- Amazon Simple Storage Service (S3)
- Amazon Virtual Private Cloud (VPC)
- Amazon API Gateway
- Application Load Balancer (ALB)
- AWS AppSync
- AWS Lambda
- AWS Batch
- Amazon Elastic Container Registry (ECR)
- Amazon EC2 Auto Scaling
- Amazon Elastic Block Store (EBS)
- Amazon VPC Internet Gateway
- Amazon VPC NAT-Gateway
- Simple Notification Service (SNS)
- Amazon Athena-Arbeitsgruppen
- Amazon Data Firehose
- Amazon ElastiCache
- Amazon Elastic MapReduce (EMR)
- Amazon Kinesis Data Streams (KDS)
- AWS Glue
- Elastic-IP-Adresse (EIP)
- Elastic Load Balancing (ELB)
- Elastic Network Interface (ENI)
Die mcdc-Befehlszeile sendet die erfassten Informationen dann an das Migrationscenter, wo Sie die Bewertung abschließen können.
Beschränkungen
Beim Ausführen einer Inventarerkennung für Ihr AWS-Konto gelten für die mcdc-Befehlszeile die folgenden Einschränkungen:
- Der TCO-Bericht enthält nur EC2- und RDS-Asset-Typen. Wenn Sie alle Asset-Typen außerhalb von Migration Center exportieren und analysieren möchten, exportieren Sie Ihr Inventar.
- Die folgenden Informationen für EC2-Instanzen werden nicht erfasst:
- Die Arbeitsspeichernutzung wird nicht erfasst. Damit diese Informationen erfasst werden können, muss der Amazon CloudWatch-Agent auf Ihren EC2-Instanzen installiert und konfiguriert sein.
- Freier Speicherplatz Führen Sie eine Gastsuchanfrage aus, um diese Informationen zu erfassen.
- Sie können die
mcdc-Befehlszeile nicht auf Linux-Computern ausführen, um Daten von AWS Windows EC2-Instanzen zu erfassen. Wenn Sie Informationen von Windows-EC2-Instanzen erfassen möchten, führen Sie diemcdc-Befehlszeile auf einem Windows-Computer aus.
Bei der Inventarermittlung erhobene Daten
Die mcdc-Befehlszeile erfasst die folgenden Informationen aus den unterstützten AWS-Diensten:
| Asset-Typ | Erfasste Daten |
|---|---|
| Amazon EC2 |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon RDS |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon S3 |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon EKS |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon ECS |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Elastic Load Balancing (ELB) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Lambda |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon CloudFront |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon EFS |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Redshift |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon VPC |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon DynamoDB |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon NAT Gateway |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Route53 |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon ECR |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Elastic-IP-Adresse (EIP) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Elastic Network Interface (ENI) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Elastic Block Store (EBS) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon EC2 Auto Scaling |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Batch |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon AppSync |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Simple Notification Service (SNS) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon API Gateway |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Internet Gateway |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Application Load Balancer (ALB) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Athena-Arbeitsgruppen |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon ElastiCache |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Elastic MapReduce (EMR) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Data Firehose |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| AWS Glue |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
| Amazon Kinesis Data Streams (KDS) |
Klicken Sie hier, um die erhobenen Daten aufzurufen.
|
Mit der mcdc-Befehlszeile werden Messwerte für die letzten 30 Tage erfasst, mit Ausnahme der Datenbank-Arbeitsspeichernutzung. Für die Datenbankspeichernutzung speichert AWS standardmäßig nur Daten für bis zu 7 Tage. Daher werden mit der mcdc-Befehlszeile nur Daten für die letzten 7 Tage erfasst.
Hinweis
Führen Sie die folgenden Schritte aus, bevor Sie mit der Inventarermittlung beginnen:
- Sehen Sie sich die Anforderungen für das Herunterladen und Ausführen der
mcdcCLI an. - Wählen Sie aus, wo Sie das
mcdc-CLI herunterladen möchten, und führen Sie die Schritte zum Herunterladen desmcdc-CLI aus. - Sie benötigen Zugriff auf Ihr AWS-Konto.
Speicherort für den Download der mcdc-Befehlszeile auswählen
Sie können die mcdc-Befehlszeile sowohl auf Linux- als auch auf Windows-Computer herunterladen. Wir empfehlen, eine Windows-EC2-Instanz zum Herunterladen und Ausführen der mcdc-CLI zu verwenden, da sie alle verfügbaren Erfassungsmethoden unterstützt.
Sie können die mcdc-Befehlszeile an einen Speicherort herunterladen, der Zugriff auf Ihre Ziel-Assets hat, z. B.:
- AWS CloudShell
- Eine Linux-EC2-Instanz
- Eine Windows EC2-Instanz
- Jeder Computer, auf dem Sie die
mcdcCLI installiert haben und auf dem Sie Remotezugriff auf Ihr AWS-Konto haben.
Eine Anleitung zum Herunterladen des mcdc-CLI finden Sie unter mcdc-CLI herunterladen.
AWS-IAM-Richtlinie erstellen
Damit die mcdc-Befehlszeile die AWS-Asset-Inventardaten lesen kann, erstellen Sie eine AWS IAM-Richtlinie mit den folgenden Berechtigungen:
Klicken Sie hier, um die IAM-Richtlinie aufzurufen.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"apigateway:GetRestApis",
"apigateway:GetTags",
"appsync:ListGraphqlApis",
"appsync:ListTagsForResource",
"athena:GetWorkGroup",
"athena:ListTagsForResource",
"athena:ListWorkGroups",
"autoscaling:DescribeAutoScalingGroups",
"batch:DescribeComputeEnvironments",
"cloudfront:ListDistributions",
"cloudfront:ListTagsForResource",
"cloudwatch:DescribeAlarms",
"cloudwatch:GetMetricData",
"cloudwatch:ListTagsForResource",
"dynamodb:DescribeContinuousBackups",
"dynamodb:DescribeTable",
"dynamodb:ListTables",
"dynamodb:ListTagsOfResource",
"ec2:DescribeAddresses",
"ec2:DescribeInstances",
"ec2:DescribeInstanceTypes",
"ec2:DescribeInternetGateways",
"ec2:DescribeNatGateways",
"ec2:DescribeNetworkAcls",
"ec2:DescribeNetworkInterfaces",
"ec2:DescribeRegions",
"ec2:DescribeSubnets",
"ec2:DescribeVolumes",
"ec2:DescribeVpcs",
"ecr:DescribeRepositories",
"ecr:GetEncryptionConfiguration",
"ecr:ListTagsForResource",
"ecs:DescribeClusters",
"ecs:DescribeContainerInstances",
"ecs:DescribeServices",
"ecs:DescribeTasks",
"ecs:ListClusters",
"ecs:ListContainerInstances",
"ecs:ListServices",
"ecs:ListTasks",
"efs:DescribeAccessPoints",
"efs:DescribeBackupPolicy",
"efs:DescribeFileSystems",
"efs:DescribeLifecycleConfiguration",
"efs:DescribeMountTargets",
"efs:DescribeReplicationConfigurations",
"efs:ListTagsForResource",
"eks:DescribeCluster",
"eks:DescribeFargateProfile",
"eks:DescribeNodegroup",
"eks:ListClusters",
"eks:ListFargateProfiles",
"eks:ListNodegroups",
"elasticache:DescribeCacheClusters",
"elasticache:ListTagsForResource",
"elasticloadbalancing:DescribeInstanceHealth",
"elasticloadbalancing:DescribeListeners",
"elasticloadbalancing:DescribeLoadBalancers",
"elasticloadbalancing:DescribeRules",
"elasticloadbalancing:DescribeTags",
"elasticloadbalancing:DescribeTargetGroups",
"elasticloadbalancing:DescribeTargetHealth",
"elasticmapreduce:DescribeCluster",
"elasticmapreduce:ListClusters",
"elasticmapreduce:ListInstanceGroups",
"firehose:DescribeDeliveryStream",
"firehose:ListDeliveryStreams",
"firehose:ListTagsForDeliveryStream",
"glue:GetJobs",
"glue:GetTags",
"kinesis:DescribeStreamSummary",
"kinesis:ListStreams",
"kinesis:ListTagsForStream",
"lambda:GetFunctionConcurrency",
"lambda:ListEventSourceMappings",
"lambda:ListFunctions",
"lambda:ListTags",
"pi:GetResourceMetrics",
"rds:DescribeDBEngineVersions",
"rds:DescribeDBInstances",
"redshift:DescribeClusters",
"redshift-serverless:GetNamespace",
"redshift-serverless:ListSnapshotCopyConfigurations",
"redshift-serverless:ListTagsForResource",
"redshift-serverless:ListWorkgroups",
"route53:GetHostedZone",
"route53:ListHostedZones",
"route53:ListResourceRecordSets",
"route53:ListTagsForResource",
"s3:GetBucketLocation",
"s3:GetBucketTagging",
"s3:GetBucketVersioning",
"s3:GetLifecycleConfiguration",
"s3:ListAllMyBuckets",
"sns:GetTopicAttributes",
"sns:ListTagsForResource",
"sns:ListTopics",
"ssm:DescribeInstanceInformation"
],
"Resource": "*"
}
]
}
Bei AWS authentifizieren
Um die mcdc-Befehlszeile für den Zugriff auf Ihre AWS-Umgebung zu autorisieren, authentifizieren Sie Ihr Konto mit einer der folgenden Methoden:
Vorhandene AWS-Anmeldedaten verwenden
Wenn Sie Ihre vorhandenen AWS-Anmeldedaten verwenden möchten, führen Sie die mcdc-CLI-Befehle direkt über die AWS Cloud Shell aus.
Wenn Sie die mcdc CLI über die AWS Cloud Shell ausführen, können Sie Ihre vorhandenen Anmeldedaten ohne Zugriffsschlüssel verwenden. In diesem Fall kann die mcdc-Befehlszeile auf Ihre AWS-Umgebung zugreifen, um AWS-Assets zu ermitteln, da der Zugriff durch Ihre Anmeldedaten gewährt wird.
Zugriffsschlüssel für die mcdc-CLI erstellen
So erstellen Sie einen Zugriffsschlüssel für die mcdc CLI:
- Erstellen Sie einen dedizierten IAM-Nutzer für die Interaktion mit der AWS API.
- Hängen Sie die im vorherigen Abschnitt erstellte IAM-Richtlinie an Ihren neuen Nutzer an.
Rufen Sie in der AWS-Konsole den IAM-Nutzer auf, den Sie im vorherigen Schritt erstellt haben, und klicken Sie auf User > Security Credentials > Create access key > Other > Next > Create access key.
Weitere Informationen finden Sie unter Zugriffsschlüssel erstellen.
Speichern Sie die Zugriffsschlüssel-ID und den Zugriffsschlüssel. Sie benötigen diese Informationen, um Ihr AWS-Inventar zu scannen.
Optional: Zugriff zum Erfassen von Gastbetriebssystemdaten einrichten
Gastbetriebssystemdaten werden in Preisberichten, Lizenzberichten und Asset-Details-Exporten verwendet. Anhand dieser Daten lässt sich auch die Eignung für Containerisierungsmigrationen zu Google Kubernetes Engine, GKE Autopilot und Cloud Run bewerten. Wenn Sie keine Betriebssystemdaten erheben möchten, können Sie diesen Abschnitt überspringen.
Zum Erfassen von Gastbetriebssystemdaten muss die Workstation, auf der die mcdc CLI ausgeführt wird, eine Verbindung zu den Ziel-EC2-Instanzen herstellen. Achten Sie darauf, dass die folgenden Ports auf den Ziel-EC2-Instanzen geöffnet sind:
- Port 22 (SSH) für Linux-Computer
- Port 135 (WMI) für Windows-Computer
Assets in Ihrem AWS-Konto ermitteln
So suchen Sie nach Assets in Ihrem AWS-Konto:
Wechseln Sie im Befehlszeilenterminal in das Verzeichnis, in das Sie die
mcdc-CLI heruntergeladen haben.Führen Sie die Erkennung aus:
AWS CloudShell
Führen Sie den folgenden Befehl aus, um Assets in Ihrem AWS-Konto zu ermitteln:
Linux
./mcdc discover aws --host-config \
[--services AWS_SERVICE_NAMES] \
[--region AWS_REGION]Windows
mcdc.exe discover aws --host-config \
[--services AWS_SERVICE_NAMES] \
[--region AWS_REGION]Ersetzen Sie Folgendes:
- AWS_SERVICE_NAMES: Die Arten von Assets, die erkannt werden sollen.
Geben Sie eine durch Kommas getrennte Liste an. Unterstützte Werte sind
alb,apigateway,appsync,athena,autoscaling,batch,cloudfront,db(RDS),dynamodb,ebs,ecr,ecs,efs,eip,eks,elasticache,elb,emr,eni,firehose,glue,internetgateway,kinesis,lambda,natgateway,redshift,route53,s3,sns,vm(EC2) undvpc. Wenn Sie dieses Flag nicht angeben, werden alle unterstützten Asset-Typen erkannt. - AWS_REGION: Die AWS-Region, in der sich Ihre EC2-Instanzen und RDS-Datenbanken befinden. Dieses Flag ist optional. Wenn Sie dieses Flag nicht angeben, werden Assets aus allen aktivierten AWS-Regionen ermittelt.
AWS-Zugriffsschlüssel
Führen Sie den folgenden Befehl aus, um Assets in Ihrem AWS-Konto mithilfe Ihrer AWS-Zugriffsschlüssel-ID und Ihres Zugriffsschlüssels zu ermitteln:
Linux
./mcdc discover aws --access-key-id AWS_ACCESS_KEY_ID \
--secret-access-key AWS_ACCESS_KEY \
[--services AWS_SERVICE_NAMES] \
[--region AWS_REGION]Windows
mcdc.exe discover aws --access-key-id AWS_ACCESS_KEY_ID \
--secret-access-key AWS_ACCESS_KEY \
[--services AWS_SERVICE_NAMES] \
[--region AWS_REGION]Ersetzen Sie Folgendes:
- AWS_ACCESS_KEY_ID: Die Zugriffsschlüssel-ID, die Sie im Abschnitt Zugriffsschlüssel für die
mcdcCLI erstellen erstellt haben. - AWS_ACCESS_KEY: Der Zugriffsschlüssel, den Sie im Abschnitt Zugriffsschlüssel für die
mcdcCLI erstellen erstellt haben. - AWS_SERVICE_NAMES: Die Arten von Assets, die erkannt werden sollen.
Geben Sie eine durch Kommas getrennte Liste an. Unterstützte Werte sind
alb,apigateway,appsync,athena,autoscaling,batch,cloudfront,db(RDS),dynamodb,ebs,ecr,ecs,efs,eip,eks,elasticache,elb,emr,eni,firehose,glue,internetgateway,kinesis,lambda,natgateway,redshift,route53,s3,sns,vm(EC2) undvpc. Wenn Sie dieses Flag nicht angeben, werden alle unterstützten Asset-Typen erkannt. - AWS_REGION: die AWS-Region, in der sich Ihre AWS-Assets befinden. Dieses Flag ist optional. Wenn Sie dieses Flag nicht angeben, werden Assets aus allen aktivierten AWS-Regionen ermittelt.
Die Ausgabe sollte in etwa so aussehen:
[+] Collecting for AWS Account: 123456789012 [+] Collecting RDS in region eu-north-1 [✓] Collected 0 DB instances [!] No DB instances found [+] Collecting ECS in region eu-north-1 [+] Successfully collected data for 2 ECS clusters in region eu-north-1 [+] Collecting S3... [+] Successfully collected data for 74 S3 buckets [✓] Collection completed.- AWS_SERVICE_NAMES: Die Arten von Assets, die erkannt werden sollen.
Geben Sie eine durch Kommas getrennte Liste an. Unterstützte Werte sind
Optional: Führen Sie den folgenden Befehl aus, um die erfassten Daten zu prüfen:
Linux
./mcdc discover ls
Windows
mcdc.exe discover ls
Die Ausgabe sollte in etwa so aussehen:
VM Assets PLATFORM VM ID NAME COLLECTED DATA OS IP ADDRESSES i-011d6234b5769fe2a abc-rhel9.0-arm AWSVM Red Hat Enterprise Linux 192.0.2.1 i-08f7e5e469508460f def-rhel9.0-arm AWSVM Red Hat Enterprise Linux 192.0.2.2 i-09e28bb6eggg94db8 ghi-ol9.3 AWSVM Linux/UNIX 192.0.2.3 Database Assets GENERATED ID PROVIDER ENGINE arn:aws:rds:eu-west-1:12345678912:db:abc-sqlserver RDS SQL Server AWS CloudFront Distribution: 2 assets were collected. AWS ECS Cluster: 3 assets were collected. AWS EFS: 5 assets were collected. AWS Elastic Load Balancer: 7 assets were collected. AWS Lambda: 9 assets were collected. AWS Redshift: 2 assets were collected. AWS S3 Bucket: 77 assets were collected. AWS VPC: 84 assets were collected.Optional können Sie mit dem Flag
--asset-typesAssets eines bestimmten Typs anzeigen lassen. Wenn Sie beispielsweise nur EC2-Instanzen anzeigen möchten, führen Sie den folgenden Befehl aus:Linux
./mcdc discover ls --asset-types=vm
Windows
mcdc.exe discover ls --asset-types=vm
Wenn Sie das Flag
--asset-typesverwenden, werden nur die folgenden Assettypen unterstützt:db: Relational Database Service (RDS)vm: Elastic Compute Cloud (EC2)
Nachdem Sie Ihre Assets ermittelt haben, können Sie sie ansehen, indem Sie die erfassten Daten in Migration Center exportieren.
Nächste Schritte
- Informationen zum Exportieren von erfassten Daten in Migration Center
- Inventar- und Leistungsdaten exportieren
- Weitere Informationen zum Generieren von TCO-Berichten