From 03d25846f016a56e8aa7d33ef742d8143d0c718d Mon Sep 17 00:00:00 2001 From: Ondra Machacek Date: Fri, 8 Nov 2024 13:45:28 +0100 Subject: [PATCH] Change the naming Change the name of the VM to MigrationAssessment. Change the name of Agent Service to Assisted Migration service. Signed-off-by: Ondra Machacek --- README.md | 4 ++-- data/AgentVM.ovf | 2 +- doc/agentservice.md | 11 --------- doc/assistedmigration.md | 11 +++++++++ doc/deployment.md | 12 +++++----- doc/{agentvm.md => migrationassessmentvm.md} | 24 ++++++++++---------- 6 files changed, 32 insertions(+), 32 deletions(-) delete mode 100644 doc/agentservice.md create mode 100644 doc/assistedmigration.md rename doc/{agentvm.md => migrationassessmentvm.md} (57%) diff --git a/README.md b/README.md index 5cabb4b..86f8bd5 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,2 @@ -# migration-planner -Plan migrations to OpenShift Virtualization +# Assisted migration +Plan migrations to OpenShift Virtualization from VMware. diff --git a/data/AgentVM.ovf b/data/AgentVM.ovf index 80386cc..30e4cf2 100644 --- a/data/AgentVM.ovf +++ b/data/AgentVM.ovf @@ -11,7 +11,7 @@ A Virtual system - AgentVM + MigrationAssessment The operating system installed Other Linux (64-bit) diff --git a/doc/agentservice.md b/doc/agentservice.md deleted file mode 100644 index 5e589e1..0000000 --- a/doc/agentservice.md +++ /dev/null @@ -1,11 +0,0 @@ -# Agent service -The Agent service is responsible for receiving and serving the collected vCenter data to the user. Once the user creates a source for their vCenter environment, the Agent service will provide a streaming service to download an OVA image. The OVA image can be booted on the vCenter enviroment to perform the collection of the vCenter data. - -## Agent API -There are two APIs related to the Agent. - -### Internal API -The API contains operations to create a source, download the OVA image, etc. By default it runs on tcp port 3443. The API is not exposed externally to users, as it is only used internally by the UI. - -### Agent API -The Agent API is exposed to communicate with the Agent VM. Its only operation is to update the status of the source. By default it runs on tcp port 7443. This API must be externally exposed so that the agent VM can initiate communication with it. diff --git a/doc/assistedmigration.md b/doc/assistedmigration.md new file mode 100644 index 0000000..eb7f91c --- /dev/null +++ b/doc/assistedmigration.md @@ -0,0 +1,11 @@ +# Assisted Migration service +The Assisted Migration service is responsible for receiving and serving the collected vCenter data to the user. Once the user creates a source for their vCenter environment, the Assisted Migration service will provide a streaming service to download an OVA image. The OVA image can be booted on the vCenter enviroment to perform the collection of the vCenter data. + +## Assisted Migration API +There are two APIs related to the Assisted Migration. + +### Internal API +The internal API contains operations to create a source, download the OVA image, etc. By default it runs on tcp port 3443. The API is not exposed externally to users, as it is only used internally by the UI. + +### External API +The extenral API is exposed to communicate with the Migration Assessment VM. Its only operation is to update the status of the source. By default it runs on tcp port 7443. This API must be externally exposed so that the Migration Assessment VM can initiate communication. diff --git a/doc/deployment.md b/doc/deployment.md index d8616c4..5d3a385 100644 --- a/doc/deployment.md +++ b/doc/deployment.md @@ -1,9 +1,9 @@ -# Deployment of the Agent service on OpenShift -The project contains yaml files for deploying the Agent service on OpenShift. This document describes the deployment process. +# Deployment of the Assisted Migration service on OpenShift +The project contains yaml files for deploying the Assisted Migration service on OpenShift. This document describes the deployment process. By default images are deployed from the `quay.io/kubev2v` namespace. New images are built and pushed to quay after each PR is merged in this repo. ## Deploy on OpenShift -In order to deploy the Agent service on top of OpenShift there is Makefile target called `deploy-on-openshift`. +In order to deploy the Assisted Migration service on top of OpenShift there is Makefile target called `deploy-on-openshift`. ``` $ oc login --token=$TOKEN --server=$SERVER @@ -18,7 +18,7 @@ To undeploy the project, which removes all the relevent parts, run: make undeploy-on-openshift ``` -## Using custom images for the Agent Service API and UI +## Using custom images for the Assisted Migration Service API and UI If you want to deploy the project with your own images you can specify custom enviroment variables: ``` @@ -27,8 +27,8 @@ export MIGRATION_PLANNER_UI_IMAGE=quay.io/$USER/migration-planner-ui make deploy-on-openshift ``` -## Using custom Agent Images used in the Agent OVA -Agent images are defined in the ignition file. In order to modify the images of the Agent you need to pass the specific environment variables to the deployment of the API service. Modify `deploy/k8s/migration-planner.yaml` and add relevant environment variables to the deployment manifest. For example: +## Using custom container images used in the Migration Asessment VM +Container images are defined in the ignition file. In order to modify the container images you need to pass the specific environment variables to the deployment of the Assisted Migration service. Modify `deploy/k8s/migration-planner.yaml` and add relevant environment variables to the deployment manifest. For example: ``` env: diff --git a/doc/agentvm.md b/doc/migrationassessmentvm.md similarity index 57% rename from doc/agentvm.md rename to doc/migrationassessmentvm.md index 59a4d29..979a049 100644 --- a/doc/agentvm.md +++ b/doc/migrationassessmentvm.md @@ -1,25 +1,25 @@ -# Agent virtual machine -The agent virtual machine, based on Red Hat CoreOS (RHCOS), communicates with the Agent Service and reports its status. -The VM is initialized using ignition, which configures multiple containers that run as systemd services. Each of these services is dedicated to a specific function. +# Migration Assessment virtual machine +The Migration Assessment virtual machine(VM), based on Red Hat CoreOS (RHCOS), communicates with the Assisted Migration Service and reports its status. +The Migration Assessment VM is initialized using ignition, which configures multiple containers that run as systemd services. Each of these services is dedicated to a specific function. ## Systemd services -The following are a list of systemd services that can be found on agent virtual machines. All of the services +The following are a list of systemd services that can be found on Migration Assessment virtual machines. All of the services are defined as quadlets. Quadlet configuration can be found in the [ignition template file](../data/ignition.template). -The Agent containerfile can be found [here](../Containerfile.agent). +The `planner-agent` containerfile can be found [here](../Containerfile.agent). ### planner-agent -Planner-agent is a service that reports the status to the Agent service. The URL of the Agent service is configured in the file `$HOME/.migration-planner/config/config.yaml`, which is injected via ignition. +Planner-agent is a service that reports the status to the Assisted Migration service. The URL of the Assisted Migration service is configured in the file `$HOME/.migration-planner/config/config.yaml`, which is injected via ignition. -The Planner-agent contains a web application that is exposed via tcp port 3333. Once the user accesses the web application and enters the credentials of their vCenter, the `credentials.json` file is created on the shared volume and the `collector` goroutine is spawned, which fetches the vCenter data. The data is stored in `$HOME/.migration-planner/data/inventory.json`. Once `inventory.json` is created, the `planner-agent` service sends the data over to Agent service. +The `planner-agent` contains a web application that is exposed via tcp port 3333. Once the user accesses the web application and enters the credentials of their vCenter, the `credentials.json` file is created on the shared volume and the `collector` goroutine is spawned, which fetches the vCenter data. The data is stored in `$HOME/.migration-planner/data/inventory.json`. Once `inventory.json` is created, the `planner-agent` service sends the data over to Assisted Migration service. ### planner-agent-opa -Planner-agent-opa is a service that re-uses the [forklift validation](https://github.com/kubev2v/forklift/blob/main/validation/README.adoc) container. The forklift validation container is responsible for vCenter data validation. When the `planner-agent-collector` fetches vCenter data, it's validated against the OPA server and the report is shared back to the Agent Service. +Planner-agent-opa is a service that re-uses the [forklift validation](https://github.com/kubev2v/forklift/blob/main/validation/README.adoc) container. The forklift validation container is responsible for vCenter data validation. When the `planner-agent-collector` fetches vCenter data, it's validated against the OPA server and the report is shared back to the Assisted Migration Service. ### podman-auto-update Podman auto update is responsible for updating the image of the containers in case there is a new image release. The default `podman-auto-update.timer` is used, which executes `podman-auto-update` every 24 hours. -## Troubleshooting Agent VM services -Useful commands to troubleshoot the Agent VM. Note that all the containers are running under the `core` user. +## Troubleshooting Migration Assessment VM services +Useful commands to troubleshoot the Migration Assessment VM. Note that all the containers are running under the `core` user. ### Listing the running podman containers ``` @@ -51,7 +51,7 @@ $ journalctl --user -f -u planner-agent ``` ### Status is `Not connected` after VM is booted. -This usually indicates that the `planner-agent` service can't communicate with the Agent service. +This usually indicates that the `planner-agent` service can't communicate with the Assisted Migration service. Check the logs of the `planner-agent` service: ``` journalctl --user -f -u planner-agent @@ -60,4 +60,4 @@ And search for the error in the log: ``` level=error msg="failed connecting to migration planner: dial tcp: http://non-working-ip:7443 ``` -Make sure `non-working-ip` has a properly setup Agent service and is listening on port `7443`. +Make sure `non-working-ip` has a properly setup Assisted Migration service and is listening on port `7443`.