Chapter 6. Deploying APIcast on Podman
This is a step-by-step guide for deploying APIcast on a Pod Manager (Podman) container environment to be used as a Red Hat 3scale API Management API gateway.
When deploying APIcast on a Podman container environment, the supported versions of Red Hat Enterprise Linux (RHEL) and Podman are as follows:
- RHEL 8.x
- Podman 1.4.2
To deploy APIcast on the Podman container environment, perform the steps outlined in the following sections:
6.1. Installing the Podman container environment
This guide covers the steps to set up the Podman container environment on RHEL 8.x. Docker is not included in RHEL 8.x, therefore, use Podman for working with containers.
For more details about Podman with RHEL 8.x, see the Container command-line reference.
Install the Podman container environment package:
sudo dnf install podman
For other operating systems, refer to the following Podman documentation:
6.2. Running the Podman environment
To run the Podman container environment, follow the procedure below.
Download a ready to use Podman container image from the Red Hat registry:
podman pull registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.9
Run APIcast in a Podman:
podman run --name apicast --rm -p 8080:8080 -e THREESCALE_PORTAL_ENDPOINT=https://<access_token>@<domain>-admin.3scale.net registry.redhat.io/3scale-amp2/apicast-gateway-rhel8:3scale2.9
<access_token>is the Access Token for the 3scale Account Management API. You can use the Provider Key instead of the access token.
<domain>-admin.3scale.netis the URL of your 3scale Admin Portal.
This command runs a Podman container engine called "apicast" on port
8080 and fetches the JSON configuration file from your 3scale Admin Portal. For other configuration options, see Installing APIcast.
6.2.1. Testing APIcast with Podman
The preceding steps ensure that your Podman container engine is running with your own configuration file and the Podman container image from the 3scale registry. You can test calls through APIcast on port
8080 and provide the correct authentication credentials, which you can get from your 3scale account.
Test calls will not only verify that APIcast is running correctly but also that authentication and reporting is being handled successfully.
Ensure that the host you use for the calls is the same as the one configured in the Public Base URL field on the Integration page.
podman command options
You can use the following option examples with the
-d: Runs the container in detached mode and prints the container ID. When it is not specified, the container runs in the foreground mode and you can stop it using
CTRL + c. When started in the detached mode, you can reattach to the container with the
podman attachcommand, for example,
podman attach apicast.
psis used to list creating and running containers. Adding
pscommand will show all containers, both running and stopped, for example,
podman ps -a.
-l: Inspect a running container. For example, use
inspectto see the ID that was assigned to the container. Use
-lto get the details for the latest container, for example,
podman inspect -l | grep Id\":.
6.4. Additional resources
- For more information about tested and supported configurations, see Red Hat 3scale API Management Supported Configurations.
- For information about getting started with Podman, see Basic Setup and Use of Podman.