Skip to content

docs: vRack 3-AZ failover priorities (port of legacy #9365)#13

Merged
Y0Coss merged 2 commits into
developfrom
port/legacy-branch-sa-vrack-3az
May 22, 2026
Merged

docs: vRack 3-AZ failover priorities (port of legacy #9365)#13
Y0Coss merged 2 commits into
developfrom
port/legacy-branch-sa-vrack-3az

Conversation

@Y0Coss
Copy link
Copy Markdown
Collaborator

@Y0Coss Y0Coss commented May 22, 2026

Ports legacy PR ovh/docs#9365 by @SlimJ4vRack — 3-AZ Failover priorities.

Summary

Documents the new vRack 3-AZ failover priorities feature in two dedicated-server guides:

  • configure-ipv6-in-vrack
  • configuring-an-ip-block-in-a-vrack

Adds a new section "Managing 3-AZ failover priorities" with benefits, mechanics, and a step-by-step procedure for adjusting the AZ priority order from the Control Panel. In the IPv6 guide, also promotes the "Host-side commands" and "Setup verification" subsections from h4 to h3 (they are no longer logically nested under the bandwidth section).

Files ported (EN + FR — matches legacy PR)

Legacy New-docs
pages/bare_metal_cloud/dedicated_servers/configure-an-ipv6-in-a-vrack/guide.en-gb.md docs/en/guides/bare-metal-cloud/dedicated-servers/configure-ipv6-in-vrack.mdx
pages/bare_metal_cloud/dedicated_servers/configure-an-ipv6-in-a-vrack/guide.fr-fr.md docs/fr/guides/bare-metal-cloud/dedicated-servers/configure-ipv6-in-vrack.mdx
pages/bare_metal_cloud/dedicated_servers/configuring-an-ip-block-in-a-vrack/guide.en-gb.md docs/en/guides/bare-metal-cloud/dedicated-servers/configuring-an-ip-block-in-a-vrack.mdx
pages/bare_metal_cloud/dedicated_servers/configuring-an-ip-block-in-a-vrack/guide.fr-fr.md docs/fr/guides/bare-metal-cloud/dedicated-servers/configuring-an-ip-block-in-a-vrack.mdx

Slug rename: configure-an-ipv6-in-a-vrack (legacy) → configure-ipv6-in-vrack (new-docs). Not present in slug-regression-report.txt; resolved via filesystem search.

Locales added beyond the legacy PR

The legacy PR only updated EN and FR. On new-docs, every locale tree has its own real translated file (no symlinks to EN), so the 3-AZ content was additionally translated into the five remaining locales for parity. Source routing: DE/PL from EN, ES/IT/PT from FR.

Locale configure-ipv6-in-vrack configuring-an-ip-block-in-a-vrack
DE ✓ section + heading promotions + date ✓ section + date
ES ✓ section + heading promotions + date ✓ section + date
IT ✓ section + heading promotions + date ✓ section + date
PL ✓ section + heading promotions + date ✓ section + date
PT ✓ section + heading promotions + date ✓ section + date

Action-button labels in the translated sections were verified with /verify-buttons:

  • Network, vRack private network, Public IP Routing — reuse the established translations already present elsewhere in each target guide.
  • Configure, Manage — matched 10/10 against common_configure / common_manage in web/client/app/core/translations/Messages_{lang}.json (DE Konfigurieren/Verwalten, ES Configurar/Gestionar, IT Configura/Gestisci, PL Konfiguruj/Zarządzaj, PT Configurar/Gerir).

Date update

Frontmatter lastUpdated: bumped from 2026-03-13 to 2026-05-22 across all 14 files. The legacy PR used a forward-dated value (2026-05-26); today's date is used instead.

Syntax conversions

Legacy → New Where
`Btn`{.action}<code className="action">Btn</code> All action-button labels in the new section
> [!primary] …:::info … ::: Both callouts in the new section
/// details | Title … ///<details><summary>Title</summary>…</details> The "Modify the Availability Zone priorities" block

Notes

  • No divergence between legacy-base and new-docs current for the affected sections.
  • No meta.yaml, infra files, or images touched.

Commits:

  1. docs(i18n): add 3-AZ failover priorities section to vRack guides (EN+FR) — 4 files (direct port).
  2. docs(i18n): translate 3-AZ failover priorities section into DE/ES/IT/PL/PT — 10 files (parity).

Both commits carry Original-URL: and Original-author: @SlimJ4 trailers.

Y0Coss added 2 commits May 22, 2026 10:54
Add a new "Managing 3-AZ failover priorities" section to two vRack guides on
dedicated servers:
- Configure an Additional IPv6 block in a vRack
- Configure an Additional IP block in a vRack

In the IPv6 guide, also promote "Host-side commands" and "Setup verification"
from h4 to h3, in line with the legacy PR's restructure.

Ports legacy PR ovh/docs#9365 (branch sa-vrack-3az).

Original-URL: ovh/docs#9365
Original-author: @SlimJ4
…PL/PT

Translate the new "Managing 3-AZ failover priorities" section into the five
remaining locales for both vRack guides on dedicated servers. Also bump
lastUpdated and, for the IPv6 guide, promote the "Host-side commands" and
"Setup verification" headings from h4 to h3 to mirror the EN/FR restructure.

Source routing: DE/PL from EN, ES/IT/PT from FR. Action-button labels
("Network", "Public IP Routing", "Configure", "Manage", "vRack private network")
match the established translations already used elsewhere in each guide.

Original-URL: ovh/docs#9365
Original-author: @SlimJ4
@Y0Coss Y0Coss merged commit 0a0600d into develop May 22, 2026
@Y0Coss Y0Coss deleted the port/legacy-branch-sa-vrack-3az branch May 22, 2026 09:23
Y0Coss added a commit that referenced this pull request May 22, 2026
* fix(theme): restore mobile burger-menu links and drop Beta badge (#7)

- NavScreen used rspress's stock useNav() which expects link:string, but our
  nav config uses links:Record<Locale,string>. The cast in rspress.config.ts
  hid the mismatch and the mobile menu rendered Webmail / customer account /
  support as inert items with no href. Switch to useLocalizedNav() so mobile
  resolves the same translated text + locale-specific URL the desktop nav does.
- Remove the hardcoded "Beta" badge next to the Documentation sidebar header
  now that the new docs platform is live and indexed.

* fix(config): point GitHub links at ovhcloud-docs instead of legacy repo (#9)

The per-guide "Edit this page" link and the navbar GitHub icon both pointed at
github.com/ovh/docs (now a deprecated branch on the legacy repo). Retarget
both editLink.docRepoBaseUrl and socialLinks at github.com/ovh/ovhcloud-docs
(develop branch) so contributors land on the active repo.

* fix(sidebar): wire 30 orphan guides into nav and add locale fallbacks (#10)

* fix(sidebar): wire 30 orphan guides into navigation and add locale fallbacks

Restore sidebar entries for 30 guides that existed in `docs/en/guides/` but were
not linked in `config/sidebar/index.md`, making them inaccessible from the
navigation. Adds 168 locale-fallback copies (fr/de/es/it/pl/pt) for the
EN-only guides so the language switcher does not redirect to home.

- Sidebar: 17 entries restored from the index-base snapshot (ClickHouse,
  Kafka, ceph-access-cluster, api-right-delegation, security-specification-pci,
  migration-from-free-to-standard) and 13 new entries (logs-data-platform
  extract-logs/nodejs/service-logs, IAM auth pages under Private Registry +
  Rancher, DB migration pages, regions comparison, hosted-exchange RACI,
  domains/web-hosting responsibility-sharing).
- Analytics regions comparison moved from Kafka to Analytics > Common >
  Key concepts (engine-agnostic).
- New `Security` subsection created under Managed Rancher Service for the
  IAM auth guide, mirroring the Private Registry pattern.
- i18n.json: added publicCloudContainersOrchestrationManagedRancherServiceSecurity
  key (Sécurité in fr, Security in others).
- Renamed hosted-echange-responsibility-model.mdx -> hosted-exchange-* (typo fix).
- 2 new FR translations: domains-responsibility-sharing,
  web-hosting-responsibility-sharing.
- 168 locale-fallback copies created from EN source with external URLs
  localized per target locale via /verify-links (~194 OVHcloud URLs updated
  across fr/de/es/it/pl/pt).

* fix(sidebar): cascade-duplicate dead-link targets to non-EN/FR locales

CI flagged dead internal links in service-logs.mdx for DE/ES/IT/PL/PT.
The targets (kms/logs and ovhcloud-connect/logs-to-customers) existed
only in EN+FR. Cascade-duplicate them to the 5 missing locales with EN
content and localized OVHcloud URLs (identity-security-operations,
professional-services).

10 new files (2 targets x 5 locales).

* docs(i18n): translate FR TOC entry on Eco dedicated server guide (#12)

Translate the "Installing or reinstalling an operating system" table-of-contents
link to "Installation ou réinstallation de votre serveur dédié", matching the
already-translated section heading below.

Ports legacy PR ovh/docs#9401 (branch jf-quick-fix-sd).

Original-URL: ovh/docs#9401
Original-author: @jessica

* docs: vRack 3-AZ failover priorities (port of legacy #9365) (#13)

* docs(i18n): add 3-AZ failover priorities section to vRack guides (EN+FR)

Add a new "Managing 3-AZ failover priorities" section to two vRack guides on
dedicated servers:
- Configure an Additional IPv6 block in a vRack
- Configure an Additional IP block in a vRack

In the IPv6 guide, also promote "Host-side commands" and "Setup verification"
from h4 to h3, in line with the legacy PR's restructure.

Ports legacy PR ovh/docs#9365 (branch sa-vrack-3az).

Original-URL: ovh/docs#9365
Original-author: @SlimJ4

* docs(i18n): translate 3-AZ failover priorities section into DE/ES/IT/PL/PT

Translate the new "Managing 3-AZ failover priorities" section into the five
remaining locales for both vRack guides on dedicated servers. Also bump
lastUpdated and, for the IPv6 guide, promote the "Host-side commands" and
"Setup verification" headings from h4 to h3 to mirror the EN/FR restructure.

Source routing: DE/PL from EN, ES/IT/PT from FR. Action-button labels
("Network", "Public IP Routing", "Configure", "Manage", "vRack private network")
match the established translations already used elsewhere in each guide.

Original-URL: ovh/docs#9365
Original-author: @SlimJ4
Kazarus4 added a commit that referenced this pull request May 22, 2026
* fix(theme): restore mobile burger-menu links and drop Beta badge (#7)

- NavScreen used rspress's stock useNav() which expects link:string, but our
  nav config uses links:Record<Locale,string>. The cast in rspress.config.ts
  hid the mismatch and the mobile menu rendered Webmail / customer account /
  support as inert items with no href. Switch to useLocalizedNav() so mobile
  resolves the same translated text + locale-specific URL the desktop nav does.
- Remove the hardcoded "Beta" badge next to the Documentation sidebar header
  now that the new docs platform is live and indexed.

* fix(config): point GitHub links at ovhcloud-docs instead of legacy repo (#9)

The per-guide "Edit this page" link and the navbar GitHub icon both pointed at
github.com/ovh/docs (now a deprecated branch on the legacy repo). Retarget
both editLink.docRepoBaseUrl and socialLinks at github.com/ovh/ovhcloud-docs
(develop branch) so contributors land on the active repo.

* fix(sidebar): wire 30 orphan guides into nav and add locale fallbacks (#10)

* fix(sidebar): wire 30 orphan guides into navigation and add locale fallbacks

Restore sidebar entries for 30 guides that existed in `docs/en/guides/` but were
not linked in `config/sidebar/index.md`, making them inaccessible from the
navigation. Adds 168 locale-fallback copies (fr/de/es/it/pl/pt) for the
EN-only guides so the language switcher does not redirect to home.

- Sidebar: 17 entries restored from the index-base snapshot (ClickHouse,
  Kafka, ceph-access-cluster, api-right-delegation, security-specification-pci,
  migration-from-free-to-standard) and 13 new entries (logs-data-platform
  extract-logs/nodejs/service-logs, IAM auth pages under Private Registry +
  Rancher, DB migration pages, regions comparison, hosted-exchange RACI,
  domains/web-hosting responsibility-sharing).
- Analytics regions comparison moved from Kafka to Analytics > Common >
  Key concepts (engine-agnostic).
- New `Security` subsection created under Managed Rancher Service for the
  IAM auth guide, mirroring the Private Registry pattern.
- i18n.json: added publicCloudContainersOrchestrationManagedRancherServiceSecurity
  key (Sécurité in fr, Security in others).
- Renamed hosted-echange-responsibility-model.mdx -> hosted-exchange-* (typo fix).
- 2 new FR translations: domains-responsibility-sharing,
  web-hosting-responsibility-sharing.
- 168 locale-fallback copies created from EN source with external URLs
  localized per target locale via /verify-links (~194 OVHcloud URLs updated
  across fr/de/es/it/pl/pt).

* fix(sidebar): cascade-duplicate dead-link targets to non-EN/FR locales

CI flagged dead internal links in service-logs.mdx for DE/ES/IT/PL/PT.
The targets (kms/logs and ovhcloud-connect/logs-to-customers) existed
only in EN+FR. Cascade-duplicate them to the 5 missing locales with EN
content and localized OVHcloud URLs (identity-security-operations,
professional-services).

10 new files (2 targets x 5 locales).

* docs(i18n): translate FR TOC entry on Eco dedicated server guide (#12)

Translate the "Installing or reinstalling an operating system" table-of-contents
link to "Installation ou réinstallation de votre serveur dédié", matching the
already-translated section heading below.

Ports legacy PR ovh/docs#9401 (branch jf-quick-fix-sd).

Original-URL: ovh/docs#9401
Original-author: @jessica

* docs: vRack 3-AZ failover priorities (port of legacy #9365) (#13)

* docs(i18n): add 3-AZ failover priorities section to vRack guides (EN+FR)

Add a new "Managing 3-AZ failover priorities" section to two vRack guides on
dedicated servers:
- Configure an Additional IPv6 block in a vRack
- Configure an Additional IP block in a vRack

In the IPv6 guide, also promote "Host-side commands" and "Setup verification"
from h4 to h3, in line with the legacy PR's restructure.

Ports legacy PR ovh/docs#9365 (branch sa-vrack-3az).

Original-URL: ovh/docs#9365
Original-author: @SlimJ4

* docs(i18n): translate 3-AZ failover priorities section into DE/ES/IT/PL/PT

Translate the new "Managing 3-AZ failover priorities" section into the five
remaining locales for both vRack guides on dedicated servers. Also bump
lastUpdated and, for the IPv6 guide, promote the "Host-side commands" and
"Setup verification" headings from h4 to h3 to mirror the EN/FR restructure.

Source routing: DE/PL from EN, ES/IT/PT from FR. Action-button labels
("Network", "Public IP Routing", "Configure", "Manage", "vRack private network")
match the established translations already used elsewhere in each guide.

Original-URL: ovh/docs#9365
Original-author: @SlimJ4

* docs(i18n): announce PG15 / MariaDB 10.11 EOL dates, update PG14 EOS/EOL (#15)

Update the Web Cloud Databases EOS/EOL announcement table across all 7
locales:
- MariaDB 10.11: announced (EOL 2026-05-22, EOS 2027-08-17, EoSupport 2028-02-16)
- PostgreSQL 14: EOS bumped to 2026-08-22, EoSupport to 2026-11-21
- PostgreSQL 15: announced (EOL 2026-05-22, EOS 2027-05-12, EoSupport 2027-11-11)

Ports legacy PR ovh/docs#9399 (branch
dev/fabien.bagard/clouddb-eol-eos).

Original-URL: ovh/docs#9399
Original-author: @Meuh-42

* fix(scripts): allow windows file paths in sidebar scripts

* docs(i18n): refresh Kafka supported-versions list (3.8 deprecated, add 3.9/4.0/4.1) (#16)

Mark Kafka 3.8 as soon-to-be-deprecated and add 3.9 / 4.0 / 4.1 to the
supported-versions list of the Public Cloud Analytics Kafka capabilities
guide, across all 7 locales.

Ports legacy PR ovh/docs#9397 (branch
public_cloud_analytics_kafka_versions).

Original-URL: ovh/docs#9397
Original-author: @thild42

* docs(i18n): k8s ip-allocation — use 3-AZ payload example (region, availabilityZones, plan) (#17)

Refresh the JSON payload example in the Managed Kubernetes
"Configure pods/services IP allocation policy" guide across all 7 locales:
- Switch example region from GRA11 to EU-WEST-PAR (multi-AZ-capable)
- Add availabilityZones to the nodepool block
- Add privateNetworkId, nodesSubnetId, and plan (required for the
  standard plan with multi-AZ)

Ports legacy PR ovh/docs#9398 (branch
fix/pedro/k8s-ip-allocation-example). Extends to DE/ES/IT/PL/PT
since the JSON example is data, not language-specific content.

Original-URL: ovh/docs#9398
Original-author: @pgaxatte

* fix(theme): persist SurveyWidget dismissal across reloads (#19)

Store a flag in localStorage when the user dismisses or responds to the
survey, so refreshing the page no longer re-displays the widget.

* All done (#20)

* docs(port): adapt legacy PRs #9392/#9393/#9394/#9400 — PCI grammar pass (#22)

* docs(port): adapt legacy PRs #9392/#9393/#9394/#9400 — PCI grammar pass

Bundled port of four legacy PRs by @Jessica41 that together form a single
grammar-and-punctuation pass over Public Cloud guides. Each legacy PR was
a review-sized slice of one effort; combined here because they share an
author, theme, base commit, and a non-overlapping file set.

Applies 186 small grammar / punctuation / whitespace fixes across all 7
primary locales (compute, network services, cross-functional).

Legacy-specific changes (community URL standardisation to /links/,
.thumbnail modifiers, Going Further footer rewrites) are intentionally
NOT ported — they are no-ops on new-docs, which addresses them
differently through migration-time normalisation.

See cp-extraction/pr-port/bundle-pr-9392-9393-9394-9400.md (in the tools
repo) for the full per-PR breakdown and per-file report.

Original-URL: ovh/docs#9392
Original-URL: ovh/docs#9393
Original-URL: ovh/docs#9394
Original-URL: ovh/docs#9400
Original-author: @Jessica41

* fix(i18n): resolve dead link in IT changing-hostname guide

Legacy slug 'public-cloud-first-steps' was renamed to 'getting-started' on
new-docs; the bundled port applied the contributor's link target verbatim
without consulting the slug rename map. Fix the one resulting dead link
caught by CI.

* docs(vps): fix Nextcloud Docker Compose connectivity and persistence (#23)

Port of legacy PR ovh/docs#9343.

- Add dedicated `internal` network for db / redis / app services
  (fixes `getaddrinfo for db failed`).
- Lowercase Redis image tag (`redis:7-alpine`) for registry compliance.
- Correct MariaDB volume path to `/var/lib/mysql` (case-sensitive FS).
- Persist Nextcloud `/config` so config.php survives container recreation.
- Add `traefik.docker.network=proxy` label on app for correct routing.

Legacy PR only touched en-gb + fr-fr; propagated to all 7 locales since
the change is inside a language-agnostic Docker Compose code block.

Original-URL: ovh/docs#9343
Original-author: @afiand

* chore(cp-steps): strip markers from non-en locales of getting-started-cloud-web (#24)

Port of legacy PR ovh/docs#9377.

The legacy PR strips `CP-STEPS-START`/`CP-STEPS-END` markers from all
non-en-gb locales across 86 guides. On new-docs, 85 of those guides
already had markers removed entirely (prior NM migration cleaned up
EN too). Only `getting-started-cloud-web` still carried markers in
every locale, and all 7 locales there are real files (not symlinks),
so each non-EN locale needed its own strip.

EN is left untouched (still holds its CP-STEPS markers), consistent
with the legacy PR keeping en-gb intact.

Original-URL: ovh/docs#9377
Original-author: @benchbzh

---------

Co-authored-by: bs-ovh <bs-ovh@ohv.com>
Co-authored-by: bs-ovh <63296875+bs-ovh@users.noreply.github.com>
Co-authored-by: Kazarus <78911684+Kazarus4@users.noreply.github.com>
@Y0Coss Y0Coss added the Bare Metal The PR documents Bare Cloud products: VPS, Dedicated Servers label May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Bare Metal The PR documents Bare Cloud products: VPS, Dedicated Servers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant