Review the migration artifacts
This page describes the migration artifacts that the Migrate to Containers CLI generates as part of your migration.
Before you begin
- You should have first created a migration plan and executed the migration.
About the generated artifact files
The artifact files generated during the migration include the following:
deployment_spec.yaml
: The YAML file that configures your workload. You can usekubectl apply
with this file to deploy the workload to another cluster, such as a production or test cluster.Dockerfile: The Dockerfile used to build the image for your migrated VM.
Some plugins might generate more than one Dockerfile and deployment_spec.yaml
file, for example if you have a VM running multiple Tomcat servers at the
same time.
Additionally, when you run the migration to a Linux system container, Migrate to Containers CLI also generates the following files:
migration.yaml
: A copy of the migration plan. You can use this file to verify what was done as part of the migration.blocklist.yaml
: The list of container services to disable based on your settings in the migration plan. Edit this file to control the list of services. For more information, see Customize the services list.logs.yaml
: A list of log files detected on the source VM. Data written to these log files by the migrated workload is forwarded to Cloud Logging. Edit this file to control log writing. For more information, see Customize log data written to Cloud Logging.
The deployment_spec.yaml
file
This file is a YAML file that you can use to deploy your workload to
another cluster, such as a test or production cluster.
If you don't configure a data migration, you will generate a Deployment
object.
When the data migration is configured, you generate a stateful set object.
Dockerfile
Use this file if you need to generate a new version of the image. For example, you might want to install a package and capture a new image afterward. Rebuilding the image can also be useful when the Migrate to Containers CLI is upgraded, for example to implement a bug fix, and you want to rebuild the image with the new Migrate to Containers CLI runtime. The upgraded runtime is available in the Container Registry.
You can edit this file like any other Dockerfile to customize your image. For tips, see Best practices for writing Dockerfiles. For information on how to edit the Dockerfile, see Post-migration image updates.
What's next
- Learn how to migrate data.