Merge pull request #4309 from ovh/gallee/vlan_id_terraform-YC

Public Cloud Network Services - Adding Terraform in private Network creation

Author: OVH-Team-Guides

pages/platform/network-services/getting-started-07-creating-vrack/guide.de-de.md

@@ -4,14 +4,14 @@ excerpt: 'Erfahren Sie hier, wie Sie Ihr vRack mit Public Cloud Instanzen einric
 slug: public-cloud-vrack
 section: Erste Schritte
 order: 07
-updated: 2023-01-10
+updated: 2023-03-03
 ---
 
 > [!primary]
 > Diese Übersetzung wurde durch unseren Partner SYSTRAN automatisch erstellt. In manchen Fällen können ungenaue Formulierungen verwendet worden sein, z.B. bei der Beschriftung von Schaltflächen oder technischen Details. Bitte ziehen Sie beim geringsten Zweifel die englische oder französische Fassung der Anleitung zu Rate. Möchten Sie mithelfen, diese Übersetzung zu verbessern? Dann nutzen Sie dazu bitte den Button «Mitmachen» auf dieser Seite.
 >
 
-**Letzte Aktualisierung am 11.01.2023**
+**Letzte Aktualisierung am 03.03.2023**
 
 ## Ziel
 
@@ -28,7 +28,7 @@ Das OVHcloud [vRack](https://www.ovh.de/loesungen/vrack/) ist ein privates Netzw
 
 ## Vorstellung der Interfaces
 
-Ob Sie Ihr vRack neu erstellen oder eine Instanz zum Netzwerk hinzufügen möchten, Sie können dazu das OVHcloud Kundencenter, die OVHcloud APIv6, die OpenStack API oder das Horizon-Interface verwenden.
+Ob Sie Ihr vRack neu erstellen oder eine Instanz zum Netzwerk hinzufügen möchten, Sie können dazu das OVHcloud Kundencenter verwenden, die OVHcloud APIv6, die OpenStack API, das Horizon-Interface oder Terraform.
 
 Je nach Ihrem technischen Profil und Ihren Bedürfnissen müssen Sie entscheiden, welches Interface oder welche Methode Sie verwenden. Für jede Aktion werden nachfolgend die möglichen Vorgehensweisen erklärt.
 
@@ -51,7 +51,7 @@ Dieses umfassende technische Interface erlaubt es Ihnen, fast alle Aktionen in O
 Lesen Sie die [Anleitung zu Horizon](https://docs.ovh.com/de/public-cloud/horizon/), um sich mit dem Interface vertraut zu machen.
 
 > [!primary]
-> Horizon mit Zonenfunktion: Denken Sie daran, Ihre Arbeitszone oben links in Ihrem Interface zu wählen (GRA5, SBG3, BHS1...).
+> Horizon mit Zonenfunktion: Denken Sie daran, Ihre Arbeitszone oben links in Ihrem Interface zu wählen (GRA5, SBG3, BHS1, etc.).
 >
 
 ### OVHcloud APIv6
@@ -95,9 +95,15 @@ Sie können dann bei Bedarf die dedizierten OpenStack APIs verwenden:
 > In einigen Fällen wird es einfacher sein, die OpenStack API zu verwenden, in anderen Fällen die APIs von Nova oder Neutron. 
 >
 > Je nach Version Ihres Clients und Betriebssystems können auch bestimmte Funktionen der OpenStack API fehlen. In dieser Anleitung werden je die einfachsten und intuitivsten Vorgehensweisen erklärt.<br>
-> Sie können auch [die offizielle Dokumentation von OpenStack einsehen](https://docs.openstack.org/xena/){.external}, wenn Sie diese tiefergehend verwenden möchten.
+> Sie können auch [die offizielle Dokumentation von OpenStack einsehen](https://docs.openstack.org/xena/){.external}, wenn Sie die API tiefergehend verwenden möchten.
 >
 
+### Terraform
+
+Terraform kann auch für die Verwaltung von OVHcloud Infrastrukturen verwendet werden.
+
+Dazu müssen Sie den richtigen Terraform-Anbieter und die richtige Terraform-Ressource auswählen. Weitere Informationen finden Sie in unserer Anleitung zur [Nutzung von Terraform mit OVHcloud (EN)](https://docs.ovh.com/de/api/terraform-at-ovhcloud/).
+
 ## In der praktischen Anwendung
 
 ### Schritt 1: vRack aktivieren und verwalten <a name="activation"></a>
@@ -126,7 +132,7 @@ Um die Konfiguration des vRack über das OVHcloud Kundencenter fortzusetzen, les
 
 Um ein vRack mit der OVHcloud APIv6 zu aktivieren und zu verwalten, lesen Sie [diesen Abschnitt](https://docs.ovh.com/gb/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-1-activating-and-managing-a-vrack) (EN) der entsprechenden Anleitung.
 
-### Schritt 2: Erstellen eines VLAN im vRack
+### Schritt 2: Erstellen eines privaten Netzwerks im vRack
 
 Es ist notwendig, ein virtuelles lokales Netzwerk (VLAN) zu erstellen, damit die mit dem vRack verbundenen Instanzen untereinander kommunizieren können.
 
@@ -152,7 +158,7 @@ Dies ist nützlich, um Ihr vRack in mehrere virtuelle Netzwerke aufzuteilen.
 >Da OpenStack nicht auf derselben Ebene der Infrastruktur liegt, können Sie die VLANs nicht über das Horizon-Interface oder die OpenStack APIs personalisieren.
 >
 
-#### Erstellen eines VLAN im OVHcloud Kundencenter <a name="kundencenter"></a>
+#### Erstellen eines privaten Netzwerks im OVHcloud Kundencenter <a name="kundencenter"></a>
 
 Sobald das vRack erstellt ist, gehen Sie zum Abschnitt `Private Network`{.action}. 
 
@@ -198,9 +204,46 @@ Wenn Sie Ihre Wahl getroffen haben, klicken Sie auf `Erstellen`{.action}, um den
 > Die Erstellung des privaten Netzwerks kann einige Minuten in Anspruch nehmen.
 >
 
-#### Erstellen eines VLAN mit der OVHcloud APIv6 <a name="vlansetup"></a>
+#### Erstellen eines privaten Netzwerks mit der OVHcloud APIv6 <a name="vlansetup"></a>
+
+Um ein privates Netzwerk mit der OVHCloud APIv6 zu erstellen, folgen Sie [diesem Abschnitt](https://docs.ovh.com/de/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) der entsprechenden Anleitung (EN).
+
+ 
+#### Ein privates Netzwerk über OpenStack CLI erstellen
+
+Um das gleiche private Netzwerk zu erstellen, müssen Sie 2 OpenStack-Objekte erstellen: *network* und *subnet*.
+
+Im folgenden Beispiel geben wir die `VLAN_ID`, zu der das Netzwerk gehören soll, über `--provider-network-type` und `--provider-segment` an.
+
+Sie können diese Einstellungen auch entfernen. In diesem Fall wird eine verfügbare `VLAN_ID` verwendet.
 
-Um ein VLAN mit der OVHCloud APIv6 zu erstellen, folgen Sie [diesem Abschnitt](https://docs.ovh.com/gb/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) (EN) der entsprechenden Anleitung.
+```bash 
+openstack network create --provider-network-type vrack --provider-segment 42 OS_CLI_private_network
+openstack subnet create --dhcp --network OS_CLI_private_network OS_CLI_subnet --subnet-range 10.0.0.0/16
+```
+
+#### Ein privates Netzwerk über Terraform erstellen
+
+In Terraform muss der Provider *openstack* verwendet werden. Ein vollständiges Beispiel für ein Terraform-Skript können Sie in [diesem Repository](https://github.com/yomovh/tf-at-ovhcloud/tree/main/private_network) herunterladen.
+
+Der bezüglich OVHcloud relevante Part für die vRack-Integration ist der Parameter `value_specs`.
+
+```hcl
+resource "openstack_networking_network_v2" "tf_network" {
+  name = "tf_network"
+  admin_state_up = "true"
+  value_specs = {
+    "provider:network_type"    = "vrack"
+    "provider:segmentation_id" = var.vlan_id
+  }
+}
+resource "openstack_networking_subnet_v2" "tf_subnet"{
+  name       = "tf_subnet"
+  network_id = openstack_networking_network_v2.tf_network.id
+  cidr       = "10.0.0.0/16"
+  enable_dhcp       = true
+}
+```
 
 ### Schritt 3: Instanz in das vRack integrieren
 

pages/platform/network-services/getting-started-07-creating-vrack/guide.en-asia.md

@@ -4,10 +4,10 @@ excerpt: 'Find out how to set up vRack for your Public Cloud instances'
 slug: public-cloud-vrack
 section: Getting started
 order: 07
-updated: 2023-01-10
+updated: 2023-03-03
 ---
 
-**Last updated 10th January 2023**
+**Last updated 3rd March 2023**
 
 ## Objective
 
@@ -24,7 +24,7 @@ The OVHcloud [vRack](https://www.ovh.com/asia/solutions/vrack/) is a private net
 
 ## Interfaces
 
-Creating a vRack or adding an instance into the network can be done using the OVHcloud Control Panel, the OVHcloud APIv6, the OpenStack API, or the Horizon interface.
+Creating a vRack or adding an instance into the network can be done using the OVHcloud Control Panel, the OVHcloud APIv6, the OpenStack API, the Horizon interface or Terraform.
 
 Depending on your technical profile and needs, it is mostly up to you which interface or method to use. For each option, the guide instructions below describe the necessary steps.
 
@@ -88,10 +88,16 @@ You will then be able to use the APIs dedicated to OpenStack as needed:
 > In some cases, it will be easier to use the OpenStack APIs and in others, Nova, Neutron, etc.
 >
 > Moreover, some features may be missing from the OpenStack API depending on the version of your client and operating system.
-For the purpose of making this guide more accessible, it presents the simplest and most intuitive options.
-You may consult the [official OpenStack documentation](https://docs.openstack.org/){.external} if you wish to go further in learning about its use.
+> For the purpose of making this guide more accessible, it presents the simplest and most intuitive options.
+> You may consult the [official OpenStack documentation](https://docs.openstack.org/){.external} if you wish to go further in learning about its use.
 >
 
+### Terraform
+
+Terraform can also be used to manage OVHcloud infrastructures.
+
+For that you need to cherry-pick the correct terraform provider & resource. Find more information in our guide on [using Terraform with OVHcloud](https://docs.ovh.com/asia/en/api/terraform-at-ovhcloud/).
+
 ## Instructions
 
 ### Step 1: Activating and managing a vRack <a name="activation"></a>
@@ -118,9 +124,9 @@ To continue the configuration of your vRack in the OVHcloud Control Panel, skip
 
 To activate and manage a vRack using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/asia/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-1-activating-and-managing-a-vrack) of the corresponding guide.
 
-### Step 2: Creating a VLAN in the vRack
+### Step 2: Creating a private network in the vRack
 
-It is necessary to create a VLAN so that the connected instances can communicate with each other.
+It is necessary to create a private network so that the connected instances can communicate with each other.
 
 With the Public Cloud service, you can create up to 4,000 VLANs within one vRack. This means that you can use each private IP address up to 4,000 times.
 Thus, for example, 192.168.0.10 of VLAN 2 is different from IP 192.168.0.10 of VLAN 42.
@@ -143,7 +149,7 @@ Using the OVHcloud APIv6, you can customise all settings: IP range (10.0.0.0/16
 > Because OpenStack is not located at the same level, you will not be able to customise VLANs through the Horizon interface or OpenStack APIs.
 >
 
-#### Creating a VLAN in the OVHcloud Control Panel
+#### Creating a private network in the OVHcloud Control Panel
 
 Once a vRack exists, click on `Private Network`{.action} in the left-hand menu under **Network**.
 
@@ -191,9 +197,45 @@ Once done, click on `Create`{.action} to start the process.
 > Creating the private network may take several minutes.
 >
 
-#### Creating a VLAN with the OVHcloud APIv6 <a name="vlansetup"></a>
+#### Creating a private network with the OVHcloud APIv6 <a name="vlansetup"></a>
+
+To create a private network using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/asia/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) of the corresponding guide.
+
+#### Creating a private network with the OpenStack CLI
+
+In order to create the same private network, we need to create 2 OpenStack objects : network and subnet.
 
-To create a VLAN using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/asia/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) of the corresponding guide.
+In the following example we specify the `VLAN_ID` to which we want the network to be part of through `--provider-network-type` and `--provider-segment`.
+
+You can remove those parameters. In that case, an available `VLAN_ID` will be used.
+
+```bash 
+openstack network create --provider-network-type vrack --provider-segment 42 OS_CLI_private_network
+openstack subnet create --dhcp --network OS_CLI_private_network OS_CLI_subnet --subnet-range 10.0.0.0/16
+```
+
+#### Creating a private network with Terraform
+
+In Terraform, you will need to use the openstack provider. You can download an example of a complete terraform script in [this repository](https://github.com/yomovh/tf-at-ovhcloud/tree/main/private_network).
+
+The OVHcloud specific part for vRack integration is the `value_specs` parameter.
+
+```hcl
+resource "openstack_networking_network_v2" "tf_network" {
+  name = "tf_network"
+  admin_state_up = "true"
+  value_specs = {
+    "provider:network_type"    = "vrack"
+    "provider:segmentation_id" = var.vlan_id
+  }
+}
+resource "openstack_networking_subnet_v2" "tf_subnet"{
+  name       = "tf_subnet"
+  network_id = openstack_networking_network_v2.tf_network.id
+  cidr       = "10.0.0.0/16"
+  enable_dhcp       = true
+}
+```
 
 ### Step 3: Integrating an instance into vRack <a name="instance-integration"></a>
 

pages/platform/network-services/getting-started-07-creating-vrack/guide.en-au.md

@@ -4,10 +4,10 @@ excerpt: 'Find out how to set up vRack for your Public Cloud instances'
 slug: public-cloud-vrack
 section: Getting started
 order: 07
-updated: 2023-01-10
+updated: 2023-03-03
 ---
 
-**Last updated 10th January 2023**
+**Last updated 3rd March 2023**
 
 ## Objective
 
@@ -24,7 +24,7 @@ The OVHcloud [vRack](https://www.ovh.com.au/solutions/vrack/) is a private netwo
 
 ## Interfaces
 
-Creating a vRack or adding an instance into the network can be done using the OVHcloud Control Panel, the OVHcloud APIv6, the OpenStack API, or the Horizon interface.
+Creating a vRack or adding an instance into the network can be done using the OVHcloud Control Panel, the OVHcloud APIv6, the OpenStack API, the Horizon interface or Terraform.
 
 Depending on your technical profile and needs, it is mostly up to you which interface or method to use. For each option, the guide instructions below describe the necessary steps.
 
@@ -88,10 +88,16 @@ You will then be able to use the APIs dedicated to OpenStack as needed:
 > In some cases, it will be easier to use the OpenStack APIs and in others, Nova, Neutron, etc.
 >
 > Moreover, some features may be missing from the OpenStack API depending on the version of your client and operating system.
-For the purpose of making this guide more accessible, it presents the simplest and most intuitive options.
-You may consult the [official OpenStack documentation](https://docs.openstack.org/){.external} if you wish to go further in learning about its use.
+> For the purpose of making this guide more accessible, it presents the simplest and most intuitive options.
+> You may consult the [official OpenStack documentation](https://docs.openstack.org/){.external} if you wish to go further in learning about its use.
 >
 
+### Terraform
+
+Terraform can also be used to manage OVHcloud infrastructures.
+
+For that you need to cherry-pick the correct terraform provider & resource. Find more information in our guide on [using Terraform with OVHcloud](https://docs.ovh.com/au/en/api/terraform-at-ovhcloud/).
+
 ## Instructions
 
 ### Step 1: Activating and managing a vRack <a name="activation"></a>
@@ -118,9 +124,9 @@ To continue the configuration of your vRack in the OVHcloud Control Panel, skip
 
 To activate and manage a vRack using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/au/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-1-activating-and-managing-a-vrack) of the corresponding guide.
 
-### Step 2: Creating a VLAN in the vRack
+### Step 2: Creating a private network in the vRack
 
-It is necessary to create a VLAN so that the connected instances can communicate with each other.
+It is necessary to create a private network so that the connected instances can communicate with each other.
 
 With the Public Cloud service, you can create up to 4,000 VLANs within one vRack. This means that you can use each private IP address up to 4,000 times.
 Thus, for example, 192.168.0.10 of VLAN 2 is different from IP 192.168.0.10 of VLAN 42.
@@ -143,7 +149,7 @@ Using the OVHcloud APIv6, you can customise all settings: IP range (10.0.0.0/16
 > Because OpenStack is not located at the same level, you will not be able to customise VLANs through the Horizon interface or OpenStack APIs.
 >
 
-#### Creating a VLAN in the OVHcloud Control Panel
+#### Creating a private network in the OVHcloud Control Panel
 
 Once a vRack exists, click on `Private Network`{.action} in the left-hand menu under **Network**. 
 
@@ -191,9 +197,45 @@ Once done, click on `Create`{.action} to start the process.
 > Creating the private network may take several minutes.
 >
 
-#### Creating a VLAN with the OVHcloud APIv6 <a name="vlansetup"></a>
+#### Creating a private network with the OVHcloud APIv6 <a name="vlansetup"></a>
+
+To create a private network using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/au/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) of the corresponding guide.
+
+#### Creating a private network with the OpenStack CLI
+
+In order to create the same private network, we need to create 2 OpenStack objects : network and subnet.
 
-To create a VLAN using the OVHcloud APIv6, please refer to [this section](https://docs.ovh.com/au/en/publiccloud/network-services/public-cloud-vrack-apiv6/#step-3-creating-a-vlan-in-the-vrack_1) of the corresponding guide.
+In the following example we specify the `VLAN_ID` to which we want the network to be part of through `--provider-network-type` and `--provider-segment`.
+
+You can remove those parameters. In that case, an available `VLAN_ID` will be used.
+
+```bash 
+openstack network create --provider-network-type vrack --provider-segment 42 OS_CLI_private_network
+openstack subnet create --dhcp --network OS_CLI_private_network OS_CLI_subnet --subnet-range 10.0.0.0/16
+```
+
+#### Creating a private network with Terraform
+
+In Terraform, you will need to use the openstack provider. You can download an example of a complete terraform script in [this repository](https://github.com/yomovh/tf-at-ovhcloud/tree/main/private_network).
+
+The OVHcloud specific part for vRack integration is the `value_specs` parameter.
+
+```hcl
+resource "openstack_networking_network_v2" "tf_network" {
+  name = "tf_network"
+  admin_state_up = "true"
+  value_specs = {
+    "provider:network_type"    = "vrack"
+    "provider:segmentation_id" = var.vlan_id
+  }
+}
+resource "openstack_networking_subnet_v2" "tf_subnet"{
+  name       = "tf_subnet"
+  network_id = openstack_networking_network_v2.tf_network.id
+  cidr       = "10.0.0.0/16"
+  enable_dhcp       = true
+}
+```
 
 ### Step 3: Integrating an instance into vRack <a name="instance-integration"></a>