API Management versions 7.5.X and 7.6.X have reached end of support in November 2020.
Check out the latest version of the documentation.

Run API Portal in Docker containers

Docker containers are software containers that wrap software in a complete file system containing everything the software in question needs to run properly, such as code, runtime, system tools, and system libraries. This guarantees that the software always runs the same way, regardless of environment. In addition, you can configure several containers to run on a single host machine, without the overhead of starting and maintaining separate virtual machines.

Docker containers enable you to run API Portal on any host operating system or cloud platform that supports Docker. For details on how to deploy your Docker infrastructure in the cloud, see the product documentation for your chosen third-party cloud platform or Platform as a Service (PaaS) environments, such as Amazon Web Services.

Because API Gateway and API Manager also support Docker containers, you can run the full API Management solution in Docker containers. This makes it easy to quickly build, test, and run API Management solutions for standalone or high availability (HA) deployment.

For more details on Docker, see the following:

Interaction example

The following diagram shows an example on how the different components interact in Docker containers:

Diagram showing an example on interaction flow

In this example, API Portal and MySQL containers are located on separate host machines but, you can also run API Portal and MySQL containers on the same host machine. However, separating the containers on different host machines allows for additional security measures.

The end user uses a browser to access API Portal using the host address and the host port of the host machine running the API Portal Docker container. The host machine interacts with the API Portal container using the port 443 to secure the connection. Behind the scenes, API Portal connects to the host address and the host port of the host machine running the MySQL Docker container. The MySQL host machine uses the port 3306 to interact with the MySQL database in the container.

Default ports

By default, API Portal uses the port 3306 for the MySQL connection and port 443 for httpd. To use different ports on the Docker containers, you can replace the default values in the code examples with your chosen ports. Ensure that you define the same MySQL port in both the MySQL and API Portal container. Additional configuration might also be required.

On the host machines running the Docker containers, you can expose any port you want. The examples in this guide use ports 443 on the API Portal host machine and port 3306 on the MySQL host machine.

API Portal resources

Axway provides the following resources for running API Portal in Docker:

  • Package containing a Dockerfile and other resources to build an API Portal Docker image that uses CentOS 7. For more information on the contents of the package, see Build and run API Portal using Dockerfile.
  • Package containing a ready-made API Portal Docker image.

You can get the API Portal packages from Axway Support at https://support.axway.com.

Note   MySQL and Redis Docker images are not included with the API Portal Docker sample package. You must download them separately from Docker Hub.

Data persistence

When you make changes that affect the file system of the API Portal container, such as customizations (template, logo) or changes to vhost file or .htaccess file, it is recommended to back up these changes.

Data is persistent as long as the Docker container exists:

  • If you stop the container, all your changes are retained when you run the container again.
  • If you remove the container, all your changes are lost, and you must either restore them from your backup, or redo them.

For more details on MySQL in Docker, see the official MySQL Docker repository.

Related Links