Kaazing Gateway Docker Tutorials

This repository provides examples of different Kaazing Gateway deployment scenarios. For ease of use and portability, these scenarios are provided using Docker.

Deployment Scenarios

Each subdirectory contains a scenario and instructions on how to run the setup locally.

• Broadcasting TCP Data to WebSocket Clients
• Enable WSS (WebSocket over TLS)
• Authenticating Users
• AMQP and WebSocket
• JMS and WebSocket
• Securing Your Deployments With Enterprise Shield™ (Firewall with no open ports for any service)
• HTTP Proxy - example coming soon.
• High Availability and Clustering - example coming soon.

Requirements

Docker and Docker Compose

These tutorials require that you have both Docker and Docker Compose installed. If you are unfamiliar with Docker there is a learning curve at the beginning, but we highly recommend getting familiar with it. Docker isn't just for production deployment. Even if you're just evaluating, prototyping, or developing, Docker is an excellent convenience that will make your life easier. It is well worth getting to know it.

Docker has some excellent documentation and tutorials. Here are some links to get you started:

• Mac
• Linux
• Windows

Host file for DNS resolution

Some of these tutorials may require hostnames that resolve to the Docker host machine. To enable this resolution, add an entry in your hosts file that points to your Docker host's IP address for the given hostname, such as example.com.

If you are using Docker Machine, you can get the IP address with this command: docker-machine ip. If you are using Kitematic, go to Settings then Ports. For other examples, see 10 Examples of how to get Docker Container IP Address.

In many cases, the IP address defaults to 192.168.99.100.

Netcat

Some of these tutorials may use netcat to simulate a client or server.

If you are running on Windows, or don't have netcat installed, everywhere you see the nc command, replace it with a Docker image that contains netcat.

For example when using netcat as a client, if you see:

$ nc 192.168.99.100 5551

then replace it with:

$ docker run -it --rm konjak/netcat 192.168.99.100 5551

Once the netcat client is connected, you can type a message and press Enter to send it to the server.

Or to run netcat in Docker as a server (in listen mode):

$ docker run -it --rm -p 9000:9000 konjak/netcat -l 9000

then connect to it via the Docker IP address:

$ nc 192.168.99.100 9000

or

docker run -it --rm konjak/netcat 192.168.99.100 9000

See the Host file for DNS resolution section, above, for steps to get your Docker IP address.

Just like the netcat client, when the netcat server has received a connection, you can type a message and press Enter to send it to the client.