Connect with message qeueue

This guide will help you establish a connection to your message queue. By default, message queues are isolated within their own namespace, making them inaccessible from other namespaces or external sources. This isolation is a security measure designed to protect your data as much as possible.

Setup connection

To setup a message queue connection from your container you need the connection information of your message queue cluster.

portal

1. Choose your Message Queue
2. Navigate to users
3. Click on the eye icon of the desired user
4. In the modal you will see all relevant information to create a connection to the message queue

Once you have obtained the necessary information, you can configure your container or container job. We strongly recommend using environment variables and secrets to configure your container, as this ensures that your password is stored securely and decouples your container image from specific credentials.

External connections

If you need an external connection to your message queue you can request a shared or dedicated IP.

Shared IP

The working of a shared IP is we provide an IPv4 and IPv6 address to you which is shared among multiple customers. We define the external port and connect it to the default port of your database.

The shared IP option comes with no costs

1. Create or Edit a Container, database or message queue

   Go to the container, database or message queue creation or edit screen in the Nexaa portal.

2. Expose the container port (only necessary for containers)

   You need to expose a port for container traffic on which the container is listening to (e.g. 3306:3306).

3. Enable Public Access (only necessary for containers)

   Toggle the setting “Make this container accessible from the internet?” to enable.

4. Add an external connection

   Here you get a small wizard where you will be walked through creating an externall connection.

   1. Select Shared IP and click Next
   2. for containers:
      • Select the port which you exposed in the previous step (e.g. 3306)
      • Select the protocol (TCP, UDP or both). In most cases just TCP is enough
   3. for containers, databases and message queues:
      • You can restrict access by specifying allowed IP-adresses in the IP Allow list section (remember to add your IPv6 address as well if you have one)
      • If left blank, the container, database or message queue will be accessible from anywhere in the world.
   4. You get an overview. Click "Enable" to add the external connection

5. Save

   Make sure to save your container, database or message queue changes to apply the domain configuration.

Imporant

Once saved, your container will become available at the shared IP which is assigned to your container, database or message queue. you can find this IP in the overview of your container, database or message queue

Dedicated IP

The dedicated IP option is the same as the shared IP with some small differences. You will get an IPv4 and IPv6 address which is allocated specially for you. You can use these IP's to connect to any of your containers, databases or message queues. No other customers can make use of these IP-addresses You can also choose yourself which external port can connect to which container port, database or message queue.

This option is the right option when you need to decide which external port needs to be connected to the container port.

The dedicated IP option comes with extra costs

1. Create or Edit a Container, database or message queue

   Go to the container creation or edit screen in the Nexaa portal.

2. Expose the container port (only necessary for containers)

   You need to expose a port for container traffic on which the container is listening to (e.g. 3306:3306).

3. Enable Public Access (only necessary for containers)

   Toggle the setting “Make this container accessible from the internet?” to enable.

4. Add an external connection

   Here you get a small wizard where you will be walked through creating an external connection.

   1. Select Dedicated IP and click Submit request
   2. For now, you need to fill in a form which will send your request to us. We will configure the connection for you and as soon as it's ready you will be notified.