Duration: 7 minutes
This tutorial will demonstrate how you can quickly setup gateway services to secure and optimize access to backend services.
As developers, we spend a large amount of time building that innovative digital application. When your ready to integrate with backend services, you’re often met with a list of corporate standards on security and performance. Now, you could open up the text editor and start coding again, but security & performance are not trivial things to solve, especially at scale. This is where a developer-friendly gateway solution whose primary focus is security and performance will allow you to accelerate the time to market of your digital application.
You gotta see it to believe it, right? so let’s get started.
It’s the same if you are starting with a project someone else has started. Just pull in the directories with the configuration and profit!
Get your DataPower engine started
We love things that simply work with minimal effort. Deploying your first DataPower Gateway should be a similar experience to driving a brand new car (without the new car smell). The following steps should get you on the highway!
- Open the docker command prompt and create a new directory called datapower. You will run your DataPower container from this directory
Pull down the DataPower docker image from DockerHub. Of course this is optional, Docker is smart enough to get the image when it is run. Still, this might be a good time to familiarize yourself with what the image provides. See the ibmcom/datapower Docker Hub page for details.
docker pull ibmcom/datapower:latest
After the download completes, the DataPower image should appear in your registry
REPOSITORY TAG IMAGE ID CREATED SIZE ibmcom/datapower latest 62ce04e36704 4 days ago 852.3 MB
Start the container for the first time with the command below:
docker run -it \ -v $PWD/config:/drouter/config \ -v $PWD/local:/drouter/local \ -e DATAPOWER_ACCEPT_LICENSE=true \ -e DATAPOWER_INTERACTIVE=true \ -p 9090:9090 \ -p 9022:22 \ -p 5554:5554 \ -p 8000-8010:8000-8010 \ --name idg \ ibmcom/datapower
- Ports: Expose ports on the host system using (-p nn:nn) or let Docker choose the ports (-p nn). If you’re running multiple containers on the same host system, you should let Docker choose the ports for you.
- /drouter/config is the location where DataPower will persist the configuration using an easy to read and editable format.
- DATAPOWER_INTERACTIVE=true prompts for login to the DataPower CLI on stdin and must be used with -it. This intermixes log output, disable DATAPOWER_LOG_STDOUT if not desired.
Login to the CLI to complete the initial setup, default username is
adminand also password is
- Enable the Web GUI – this will be your primary development interface
configure; web-mgmt 0 9090 9090;
- Hooray! You have completed the initial setup. Open a Web browser to
https://localhost:9090and login to the Web GUI using the username
- Make a note of the directories created when you run the container. These directories are mounted from the container file system to your local file system. Any edits from your workstation are picked up immediately.
$ ls config local
In this section, you pulled down the latest DataPower Docker image and started the DataPower container. You performed some basic configuration to enable the Web GUI.
Next Step: Experience the CLI and WebUI