--- title: "Pierwsze kroki z OVHcloud Public Cloud Gateway" description: "Twórz Gateway Public Cloud i zarządzaj nimi za pomocą Panelu klienta OVHcloud, API, ovhcloud-cli lub Terraform." url: https://docs.ovhcloud.com/pl/guides/public-cloud/network-services/getting-started-gateway lang: pl lastUpdated: 2026-06-11 --- # Pierwsze kroki z OVHcloud Public Cloud Gateway ## Wprowadzenie [Gateway](https://www.ovhcloud.com/pl/public-cloud/gateway/) OVHcloud zapewnia bezpieczną łączność wychodzącą (SNAT) dla instancji w podsieci sieci prywatnej i jest wymagana w tej podsieci, aby korzystać z [Floating IP](https://www.ovhcloud.com/pl/public-cloud/floating-ip/) w celu publicznego udostępnienia tych prywatnych zasobów. **Niniejszy przewodnik wyjaśnia, jak tworzyć, wyświetlać, modyfikować i usuwać Gateway Public Cloud za pomocą Panelu klienta OVHcloud, API OVHcloud, ovhcloud-cli lub Terraform.** ## Wymagania początkowe - Posiadanie [projektu Public Cloud](https://www.ovhcloud.com/pl/public-cloud/) na koncie OVHcloud - Posiadanie sieci prywatnej z co najmniej jedną podsiecią w docelowym regionie (zobacz [Konfiguracja vRack dla Public Cloud](/pl/guides/public-cloud/network-services/vrack.md)) - **Dla API OVHcloud:** dane uwierzytelniające API OVHcloud ([Pierwsze kroki z API OVHcloud](/pl/guides/manage-and-operate/api/first-steps.md)) - **Dla ovhcloud-cli:** zainstalowane i skonfigurowane [ovhcloud-cli](https://github.com/ovh/ovhcloud-cli) z Twoimi danymi uwierzytelniającymi - **Dla Terraform:** zainstalowany Terraform i skonfigurowany dostawca OVH ([Jak korzystać z Terraform z OVHcloud](/pl/guides/public-cloud/cross-functional/how-to-use-terraform.md)) *** ### Dostęp do Panelu klienta OVHcloud - **Link bezpośredni:** Projekty Public Cloud - **Ścieżka nawigacji:** Public Cloud > Wybierz swój projekt *** ## W praktyce ### Modele Gateway Przed utworzeniem Gateway wybierz model odpowiadający Twoim potrzebom w zakresie przepustowości: | Model | Przepustowość | | ----- | ------------- | | S | do 200 Mbps | | M | do 500 Mbps | | L | do 2 Gbps | | XL | do 4 Gbps | | 2XL | do 8 Gbps | | 3XL | do 16 Gbps | ### Tworzenie Gateway **Panel klienta OVHcloud** W projekcie Public Cloud kliknij Gateway w menu po lewej stronie w sekcji **Network**, a następnie kliknij Utwórz Gateway. 1. **Wybierz region.** Wybierz region, w którym wdrożone są Twoje prywatne instancje. 2. **Wybierz rozmiar.** Wybierz model Gateway w zależności od Twoich potrzeb w zakresie przepustowości (zobacz powyższą tabelę). 3. **Nazwij i przypisz sieć.** Wpisz nazwę Gateway i wybierz istniejącą sieć prywatną z listy rozwijanej lub kliknij Dodaj sieć prywatną, aby utworzyć ją bezpośrednio. 4. Kliknij Utwórz Gateway, aby potwierdzić. Provisioning Gateway zajmuje kilka minut. Po utworzeniu Gateway pojawia się w sekcji Gateway, a przypisana sieć prywatna jest widoczna w sekcji Sieci prywatne. :::info Gateway obsługuje wyłącznie sieci prywatne jednoregionowe. ::: **API OVHcloud** Połącz się z [API OVHcloud](https://api.ovh.com/console/) i użyj poniższego wywołania, aby utworzyć Gateway wraz z nową siecią prywatną i podsiecią w jednej operacji: 🇪🇺EU▾ [POST/cloud/project/{serviceName}/region/{regionName}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#post-/cloud/project/-serviceName-/region/-regionName-/gateway) | Pole | Opis | | -------------------- | ------------------------------------------------------------------------- | | `serviceName` | Identyfikator Twojego projektu Public Cloud | | `regionName` | Region docelowy (np. `GRA9`) | | `model` | Rozmiar Gateway: `s`, `m`, `l`, `xl`, `2xl`, `3xl` | | `name` | Nazwa Twojej Gateway | | `network.name` | Nazwa nowej sieci prywatnej | | `network.cidr` | CIDR podsieci (np. `192.168.1.0/24`) | | `network.enableDhcp` | `true`, aby aktywować DHCP w podsieci | | `network.ipVersion` | `4` (IPv6 jeszcze nieobsługiwane) | | `network.vlanId` | Identyfikator VLAN (2–4000) lub puste pole dla automatycznego przypisania | Wywołanie zwraca obiekt `cloud.Operation`. Aby przypisać Gateway do **istniejącej** podsieci, użyj: 🇪🇺EU▾ [POST/cloud/project/{serviceName}/region/{regionName}/network/{networkId}/subnet/{subnetId}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#post-/cloud/project/-serviceName-/region/-regionName-/network/-networkId-/subnet/-subnetId-/gateway) Aby pobrać identyfikator Twojego projektu: 🇪🇺EU▾ [GET/cloud/project](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project) **ovhcloud-cli** Użyj `ovhcloud cloud network gateway create` z regionem docelowym i opcją `--wait`, aby zaczekać na zakończenie provisioningu. **Utworzenie Gateway w istniejącej sieci prywatnej:** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-id \ --subnet-id \ --wait ``` **Utworzenie Gateway z nową siecią prywatną:** ```bash ovhcloud cloud network gateway create \ --cloud-project \ --name my-gateway \ --model s \ --network-name my-network \ --subnet-cidr 192.168.1.0/24 \ --subnet-enable-dhcp \ --wait ``` Dostępne modele: `s`, `m`, `l`, `xl`, `2xl`, `3xl`. **Terraform** Utwórz plik konfiguracyjny Terraform (np. `gateway.tf`) z następującymi zasobami: ```hcl resource "ovh_cloud_project_network_private" "mypriv" { service_name = "" vlan_id = "0" name = "my-network" regions = ["GRA9"] } resource "ovh_cloud_project_network_private_subnet" "myprivsub" { service_name = ovh_cloud_project_network_private.mypriv.service_name network_id = ovh_cloud_project_network_private.mypriv.id region = "GRA9" start = "10.0.0.2" end = "10.0.255.254" network = "10.0.0.0/16" dhcp = true } resource "ovh_cloud_project_gateway" "gateway" { service_name = ovh_cloud_project_network_private.mypriv.service_name name = "my-gateway" model = "s" region = ovh_cloud_project_network_private_subnet.myprivsub.region network_id = tolist(ovh_cloud_project_network_private.mypriv.regions_attributes[*].openstackid)[0] subnet_id = ovh_cloud_project_network_private_subnet.myprivsub.id } ``` Zastosuj konfigurację: ```bash terraform init terraform apply ``` :::info Zastąp `GRA9` swoim regionem docelowym, a `` identyfikatorem Twojego projektu Public Cloud. ::: ### Wyświetlanie Gateway **Panel klienta OVHcloud** W projekcie Public Cloud kliknij Gateway w menu po lewej stronie w sekcji **Network**. Na stronie wyświetlane są wszystkie Gateway w Twoim projekcie wraz z ich regionem, modelem, statusem i przypisaną siecią. **API OVHcloud** 🇪🇺EU▾ [GET/cloud/project/{serviceName}/region/{regionName}/gateway](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project/-serviceName-/region/-regionName-/gateway) | Pole | Opis | | ------------- | -------------------------------------------------------------------- | | `serviceName` | Identyfikator Twojego projektu Public Cloud | | `regionName` | Region docelowy | | `subnetId` | (Opcjonalnie) Filtrowanie według identyfikatora przypisanej podsieci | | `withSubnets` | (Opcjonalnie) Dołączenie szczegółów podsieci do odpowiedzi | **ovhcloud-cli** ```bash ovhcloud cloud network gateway list --cloud-project ``` Filtrowanie według wzorca nazwy: ```bash ovhcloud cloud network gateway list \ --cloud-project \ --filter 'name=~"^my-.*"' ``` ### Modyfikacja Gateway Możesz zmienić nazwę lub model (rozmiar) istniejącej Gateway. **Panel klienta OVHcloud** Na liście Gateway kliknij menu ... obok Twojej Gateway, a następnie wybierz Edytuj. Zmień nazwę lub wybierz nowy model, a następnie potwierdź. **API OVHcloud** 🇪🇺EU▾ [PUT/cloud/project/{serviceName}/region/{regionName}/gateway/{id}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#put-/cloud/project/-serviceName-/region/-regionName-/gateway/-id-) Przekaż pola, które chcesz zmienić, w treści żądania (`name`, `model` lub oba). **ovhcloud-cli** ```bash ovhcloud cloud network gateway edit \ --cloud-project \ --name new-name \ --model m ``` Możesz użyć `--name`, `--model` lub obu. **Terraform** Zmień pole `name` lub `model` w bloku zasobu `ovh_cloud_project_gateway`, a następnie zastosuj: ```bash terraform apply ``` ### Usuwanie Gateway :::warning Usunięcie Gateway jest nieodwracalne. Instancje korzystające z niej do łączności wychodzącej utracą dostęp do internetu. ::: **Panel klienta OVHcloud** Na liście Gateway kliknij menu ... obok Twojej Gateway, a następnie wybierz Usuń i potwierdź. **API OVHcloud** 🇪🇺EU▾ [DELETE/cloud/project/{serviceName}/region/{regionName}/gateway/{id}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#delete-/cloud/project/-serviceName-/region/-regionName-/gateway/-id-) Wywołanie zwraca `cloud.Operation`. Usuwanie jest asynchroniczne — w razie potrzeby sprawdź status operacji: 🇪🇺EU▾ [GET/cloud/project/{serviceName}/operation/{operationId}](https://eu.api.ovh.com/console/?section=/cloud&branch=v1#get-/cloud/project/-serviceName-/operation/-operationId-) **ovhcloud-cli** ```bash ovhcloud cloud network gateway delete \ --cloud-project ``` **Terraform** Usuń blok zasobu `ovh_cloud_project_gateway` z pliku konfiguracyjnego, a następnie zastosuj: ```bash terraform apply ``` Aby usunąć wszystkie zasoby z konfiguracji: ```bash terraform destroy ``` ## Sprawdź również - [Tworzenie sieci prywatnej z Gateway](/pl/guides/public-cloud/network-services/create-private-network-gateway.md) - [Przypisywanie Floating IP do instancji Public Cloud](/pl/guides/public-cloud/network-services/attach-floating-ip-to-instance.md) - [Koncepcje sieciowe Public Cloud](/pl/guides/public-cloud/network-services/concepts.md) - [Jak korzystać z Terraform z OVHcloud](/pl/guides/public-cloud/cross-functional/how-to-use-terraform.md) Jeśli potrzebujesz szkolenia lub pomocy technicznej przy wdrażaniu naszych rozwiązań, skontaktuj się ze swoim opiekunem handlowym lub przejdź na stronę [Professional Services](https://www.ovhcloud.com/pl/professional-services/), aby otrzymać wycenę i poprosić naszych ekspertów z zespołu Professional Services o spersonalizowaną analizę Twojego projektu. Dołącz do [grona naszych użytkowników](https://community.ovhcloud.com/).