Page

Collect your data into a directory

September 19, 2024

Red Hat Developer Editorial Team

Move2Kube is a tool that helps automate your migration to Kubernetes from platforms like Cloud Foundry or Docker Compose. It analyzes source files, such as manifest files, and generates the deployment artifacts required to deploy the application in Kubernetes.

Prerequisites:

Access to the Developer Sandbox for Red Hat OpenShift
This example uses data from the move2kube-demos repository on GitHub.

To transform a Cloud Foundry application to Kubernetes, simply execute the following command:

$ move2kube transform -s cloud-foundry

Move2Kube will automatically analyze the artifacts in the cloud-foundry directory and transform and create all artifacts required for deploying the application in Kubernetes.

Create a source code directory

First, you will need a directory that contains the source code files and the manifest.yml file of a Cloud Foundry application.

In this learning path, we will use the cloud-foundry sample directory from the move2kube-demos repository:

$ curl https://move2kube.konveyor.io/scripts/download.sh | bash -s -- -d samples/cloud-foundry -r move2kube-demos

Let's see the structure inside the ./cloud-foundry directory. The cloud-foundry directory contains the source code files and the manifest.yml file:

$ tree cloud-foundry

cloud-foundry/

  ├── cfnodejsapp

  │   ├── main.js

  │   ├── manifest.yml

  │   ├── package-lock.json

  │   └── package.json

  └── m2k_collect

   └── cf

       └── cfapps.yaml

Next, install the following tools:
- Move2Kube
- Docker or Podman
- kubectl
To verify that dependencies were installed correctly, you can run any of the following commands:
- $ move2kube version
- $ docker version
- $ podman info
- $ kubectl version
Finally, install the Cloud Foundry CLI.

The example application

To demonstrate how to migrate a Cloud Foundry application to Kubernetes with Move2Kube, we will use the source code inside the cloud-foundry/cfnodejsapp directory.

If you want to try out Move2Kube on your Cloud Foundry application, then in place of our sample cloud-foundry directory, provide the path of the source directory (containing the source code and/or manifest files) of your Cloud Foundry application to Move2Kube during the plan phase.

Deploy to Cloud Foundry

Optional step: Here we will deploy a simple Node.js application into Cloud Foundry. If you already have a running Cloud Foundry application, you can use that instead.

Provision a Cloud Foundry app with the name cfnodejsapp using your cloud provider (e.g., IBM Cloud).
Make note of the API endpoint. (You can find a list of supported API endpoints for the IBM Cloud Foundry service in the documentation).
Log in to Cloud Foundry using the following command:
```
$ cf login -a <YOUR CF API endpoint>
```
Run the following commands to deploy the sample application to Cloud Foundry. The sample application’s source code is present inside the ./cloud-foundry/cfnodejsapp folder.
```
$ cf push -f ./cloud-foundry/cfnodejsapp -p ./cloud-foundry/cfnodejsapp
```

You can visit the URL of the application (you can get this by running cf apps) to see it running.

Generate target artifacts

Now that we have a running Cloud Foundry application, we can transform it using Move2Kube. We will use a three-stage process (collect, plan, and transform) for the transformation. Be sure to run these steps from the directory where the cloud-foundry directory is located.