Creating a Docker Project¶
Create a Docker project if you want to deploy your integration solutions inside a Docker environment. This project directory allows you to package multiple integration projects into a single Docker image and then build and push to the Docker registries.
If you want to simultaneously create all the projects required for your use case, read about the integration project solution.
Creating the Docker project¶
Follow the steps given below.
Open WSO2 Integration Studio and click Miscellaneous → Create New Docker Project in the Getting Started view as shown below.
In the New Docker Project dialog that opens, enter a name for the Docker project and other parameters as shown below.
Enter the following information:
Parameter Description Docker Project Name Required. Give a name for the Docker project. Base Image Repository Required. Select the base Micro Integrator Docker image for your solution. Use one of the following options:
- wso2/micro-integrator: This is the community version of the Micro Integrator Docker image, which is stored in the public WSO2 Docker registry. This is selected by default.
- docker.wso2.com: This is the Micro Integrator Docker image that includes product updates. This image is stored in the private WSO2 Docker registry. Note that you need a valid WSO2 subscription to use the Docker image with updates.
- You can also use a custom Docker image from a custom repository.
Base Image Tag Required. Specify the tag of the base image that you are using. Target Image Repository Required. The Docker repository to which you will later push this Docker image.
- If your repository is in Docker Hub, use the docker_user_name/repository_name format.
- If you are using any other repository, use the repository_url/repository_user_name/repository_name forrmat.
Target Image Tag Required. Give a tag name for the Docker image. Environment Variables You can enter multiple environment variables as key-value pairs.
Optionally, click Next and configure Maven details for the Docker project.
Click Finish. The Docker project is created in the project explorer.
The Docker project directory¶
Expand the Docker Exporter Project in the project explorer. See that the following folders and files are created:
|Libs||This folder stores libraries that should be copied to the Docker image. During the build time, the libraries inside this directory will be copied to the image.|
|Resources||This folder stores additional files and resources that should be copied to the Docker image. During the build time, the resources inside this directory will be copied to the image.|
|deployment.toml||The product configuration file.|
|Dockerfile||The Dockerfile containing the build details.|
|pom.xml||The file for selecting the relevant composite applications that should be included in the Docker image. This information is also used when you later build and push Docker images to the Docker registries.|
Build Docker images¶
Follow the steps given below.
Open the pom.xml file inside the Docker project and click Refresh on the top-right. Your composite application project with integration artifacts will be listed under Dependencies as follows:
Select the composite applications that you want to package inside the Docker image.
- If required, you can update the Target Repository to which the image should be pushed and the Target Tag.
- Save the POM file and click Build to start the Docker image build.
It will build the Docker image based on the Dockerfile and the Target details. When the image is created, the following message will display.