External transformer illustration
The custom transformer used in this case is the same as add-custom-files-directories-in-custom-locations. We will use the same case to describe the usefulness of external transformers.
Move2Kube allows defining containerized or native transformers where-in the directory_detect and transform operations are external scripts residing within the container or natively that are invoked by Move2Kube (Checkout the external transform description here).
- Let us start by creating an empty workspace directory say
workspaceand make it the current working directory. We will assume all commands are executed within this directory.$ mkdir workspace && cd workspace - Lets use the enterprise-app as input for this flow.
$ curl https://move2kube.konveyor.io/scripts/download.sh | bash -s -- -d samples/enterprise-app/src -r move2kube-demos $ ls src README.md config-utils customers docs frontend gateway ordersIn this project, all the apps have a pom.xml file. Lets use a custom transformer to put a helm chart created out of a template into each of those project directories.
- We will use the external transformer which is native or containerized. We copy it into the
customizationssub-directory.$ curl https://move2kube.konveyor.io/scripts/download.sh | bash -s -- -d native-external-transformer -r move2kube-transformers -o customizationsOR
$ curl https://move2kube.konveyor.io/scripts/download.sh | bash -s -- -d containerized-external-transformer -r move2kube-transformers -o customizations - Now lets transform with this customization. Specify the customization using the
-cflag.$ move2kube transform -s src/ -c customizations/You could hit ENTER for all questions so that the default answer is picked by Move2Kube. Only for below questions, provide
Yas input for the following question in the QA flow: ``` ? Allow spawning containers? ID: move2kube.spawncontainers Hints:- If this setting is set to false, those transformers that rely on containers will not work.
(y/N)
Once the output is generated, we can observe one helm-chart is generated for each service and placed within the service directory. Also, note that every helm-chart project is named after the service it is meant for. The contents are shown below for reference:$ tree myproject myproject/ ├── config-utils │ ├── helm-chart │ │ └── config-utils │ │ ├── Chart.yaml │ │ ├── templates │ │ │ ├── config-utils-deployment.yaml │ │ │ ├── config-utils-ingress.yaml │ │ │ └── config-utils-service.yaml │ │ └── values.yaml │ ├── pom.xml │ └── src │ └── main │ └── java │ └── io │ └── konveyor │ └── demo │ └── config │ └── ApplicationConfiguration.java ├── customers │ ├── Makefile │ ├── helm-chart │ │ └── customers │ │ ├── Chart.yaml │ │ ├── templates │ │ │ ├── customers-deployment.yaml │ │ │ ├── customers-ingress.yaml │ │ │ └── customers-service.yaml │ │ └── values.yaml │ ├── pom.xml │ └── src │ └── main │ ├── java │ │ └── io │ │ └── konveyor │ │ └── demo │ │ └── ordermanagement │ │ ├── OrderManagementAppInitializer.java │ │ ├── config │ │ │ ├── PersistenceConfig.java │ │ │ └── WebConfig.java │ │ ├── controller │ │ │ └── CustomerController.java │ │ ├── exception │ │ │ ├── ResourceNotFoundException.java │ │ │ └── handler │ │ │ └── ExceptionHandlingController.java │ │ ├── model │ │ │ └── Customer.java │ │ ├── repository │ │ │ └── CustomerRepository.java │ │ └── service │ │ └── CustomerService.java │ └── resources │ ├── import.sql │ └── persistence.properties └── gateway ├── helm-chart │ └── snowdrop-dependencies │ ├── Chart.yaml │ ├── templates │ │ ├── snowdrop-dependencies-deployment.yaml │ │ ├── snowdrop-dependencies-ingress.yaml │ │ └── snowdrop-dependencies-service.yaml │ └── values.yaml ├── manifest.yml ├── pom.xml └── src ├── main │ ├── java │ │ ├── META-INF │ │ │ └── MANIFEST.MF │ │ └── io │ │ └── konveyor │ │ └── demo │ │ └── gateway │ │ ├── Application.java │ │ ├── command │ │ │ └── ProductCommand.java │ │ ├── controller │ │ │ ├── CustomersController.java │ │ │ ├── InventoryController.java │ │ │ └── OrdersController.java │ │ ├── exception │ │ │ ├── ResourceNotFoundException.java │ │ │ └── handler │ │ │ └── ExceptionHandlingController.java │ │ ├── model │ │ │ ├── Customer.java │ │ │ ├── Order.java │ │ │ ├── OrderItem.java │ │ │ ├── OrderSummary.java │ │ │ └── Product.java │ │ ├── repository │ │ │ ├── CustomerRepository.java │ │ │ ├── GenericRepository.java │ │ │ ├── InventoryRepository.java │ │ │ └── OrderRepository.java │ │ ├── serialization │ │ │ ├── CustomerDeserializer.java │ │ │ └── ProductDeserializer.java │ │ └── service │ │ ├── CustomersService.java │ │ ├── InventoryService.java │ │ └── OrdersService.java │ └── resources │ ├── application-local.properties │ ├── application-openshift.properties │ └── bootstrap.properties └── test ├── java │ └── io │ └── konveyor │ └── demo │ └── gateway │ ├── controller │ │ └── OrdersControllerTest.java │ ├── model │ │ └── OrderTest.java │ ├── repository │ │ ├── CustomerRepositoryTest.java │ │ ├── InventoryRepositoryTest.java │ │ └── OrderRepositoryTest.java │ └── service │ └── OrdersServiceTest.java └── resources ├── application-test.properties └── bootstrap.properties```