Creating a Private Network with a Gateway – Articles

Learn how to create a private network with a gateway.

A Gateway offers a secure outbound connection method from your private network instances or the ability to use Floating IPs with your instance or Load Balancer for service exposition.

This can be created via the OVHcloud Control Panel, the OpenStack API, or the OVHcloud API.

Requirements

a Public Cloud project in your OVHcloud account
access to the OVHcloud API, the OVHcloud Control Panel, or the OpenStack command line environment (Tutorial)
the OpenStack Command Line Interface tool installed on your working environment (optional)

Instructions

Via the OVHcloud Control Panel

Jump to: via OpenStack API | via OVHcloud API

Click on Gateway in the left-hand menu under Network.

Please note that you need to have activated the vRack before proceeding, if you do not have a vRack, please consult this section of the relevant guide.

Next, click on Create a Gateway.

PCI_network_gs_privatenetworkgateway01**.png

Configure and create your private network and gateway.

Select the size (S, M, or L).
Select the region. It is best to create a Public Gateway in the region where you intend to deploy your private instances.
Name your gateway and select a private network. Be aware that only single-region private networks are supported by Gateway.
You can also add a new private network. Click on Add a private network to create one.

In the pop-up window, enter a name for your private network, select a subnet, and click on Add.

Once the network has been added, click on Create a gateway.

The creation may take several minutes, you may need to refresh the page after a couple of minutes to display the new service.

Once the creation is done, you now have a private network linked to a public gateway.

To view your newly created private network, click on Private Networks in the left-hand menu under Network.

You can view the new gateway in the Gateway section.

Via the OpenStack API

Before proceeding, it is recommended that you consult these guides:

Once your environment is ready, type the following at the command line:

openstack network create my_network

openstack subnet create my_subnet --subnet-range <my_private_ip_range/mask> --network my_network --no-dhcp

openstack router create my_router

openstack router add subnet my_router my_subnet

openstack router set --external-gateway Ext-Net my_router

Via the OVHcloud API

Step 1

In case the project ID is unknown, the calls below allow you to retrieve it.

This call retrieves the list of projects.

GET /cloud/project

This call identifies the project via the "description" field.

GET /cloud/project/{serviceName}

Step 2

Create your private network and gateway

POST /cloud/project/{serviceName}/region/{regionName}/gateway

Fill in the fields according to the following table.

Field	Description
serviceName	'The ID of your project'
regionName	Example: US-VA-EAST-1
model	size of your gateway (l, m ,s) depending on your needs
name	set a name for your gateway, you can click on the dropdown arrow and select "null" for a default one
name	set a name for your private network, you can click on the dropdown arrow and select "null" for a default one
cidr	IP block for your subnet
enableDhcp	check the box for yes
ipVersion	4

The VLAN identifier (vlanId) is required if you want to create a specific VLAN. You can enter a value (between 2 - 4000) or leave it empty. If left empty, the system will automatically assign one by default.

This is the step of creating the private network and gateway by region.

You will need to do the same for each region where your private instances are present.

The creation will take a few minutes.

To verify the details of your gateway, you can use the following API call:

GET /cloud/project/{serviceName}/region/{regionName}/gateway

Go further

For more information and tutorials, please see our other Public Cloud support guides or explore the guides for other OVHcloud products and services.

Articles in this section