fix: links (#613)

aiven · Dec 19, 2024 · 9491798 · 9491798
1 parent 8486326
commit 9491798
Show file tree

Hide file tree

Showing 16 changed files with 59 additions and 57 deletions.
diff --git a/docs/platform/concepts/byoc.md b/docs/platform/concepts/byoc.md
@@ -33,13 +33,13 @@ infrastructure on the Aiven platform while keeping your data in your own cloud.
 
 1. [Enable BYOC](/docs/platform/howto/byoc/enable-byoc) in your Aiven organization by
    setting up a call with the Aiven sales team to share your use case and its requirements.
-1. [Create a custom cloud](/docs/platform/howto/byoc/create-custom-cloud) in the Aiven
+1. [Create a custom cloud](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in the Aiven
    Console or CLI by providing cloud setup details essential to generate your custom cloud
    infrastructure template.
 1. **Integrate your cloud account with Aiven** by applying the infrastructure template for
-   [AWS](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#deploy-the-template)
+   [AWS](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#deploy-the-template)
    or
-   [Google Cloud](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#deploy-the-template).
+   [Google Cloud](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#deploy-the-template).
 1. [Deploy services](/docs/platform/howto/byoc/manage-byoc-service) by creating new
    Aiven-managed services in the custom cloud or migrating existing Aiven-managed services
    to the custom cloud.
@@ -231,5 +231,5 @@ Aiven deployment model.
 
 -   [Bring your own cloud networking and security](/docs/platform/howto/byoc/networking-security)
 -   [Enable bring your own cloud (BYOC)](/docs/platform/howto/byoc/enable-byoc)
--   [Create a custom cloud in Aiven](/docs/platform/howto/byoc/create-custom-cloud)
+-   [Create a custom cloud in Aiven](/docs/platform/howto/byoc/create-cloud/create-custom-cloud)
 -   [Manage services hosted in custom clouds](/docs/platform/howto/byoc/manage-byoc-service)
diff --git a/docs/platform/howto/byoc/add-customer-info-custom-cloud.md b/docs/platform/howto/byoc/add-customer-info-custom-cloud.md
@@ -11,9 +11,9 @@ import ConsoleLabel from "@site/src/components/non-swizzled/ConsoleIcons";
 Update the list of customer contacts for your [custom cloud](/docs/platform/concepts/byoc).
 
 With the [BYOC feature enabled](/docs/platform/howto/byoc/enable-byoc), you can
-[create custom clouds](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+[create custom clouds](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
 organizations. While
-[creating a custom cloud](/docs/platform/howto/byoc/create-custom-cloud), you add at least
+[creating a custom cloud](/docs/platform/howto/byoc/create-cloud/create-custom-cloud), you add at least
 the **Admin** contact so that the Aiven team can reach out to them if needed. You can change
 the provided contacts any time later by following
 [Update the contacts list](#update-the-contacts-list).
@@ -28,15 +28,15 @@ a mandatory role that is always required as a primary support contact.
 <Tabs groupId="group1">
 <TabItem value="1" label="Aiven Console" default>
 -   At least one
-    [custom cloud created](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+    [custom cloud created](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
     organization
 -   Access to the [Aiven Console](https://console.aiven.io/)
 -   [Organization admin](/docs/platform/concepts/permissions#organization-roles-and-permissions)
     role in your Aiven organization
 </TabItem>
 <TabItem value="2" label="Aiven CLI">
 -   At least one
-    [custom cloud created](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+    [custom cloud created](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
     organization
 -   [Aiven CLI client](/docs/tools/cli) installed
 -   [Organization admin](/docs/platform/concepts/permissions#organization-roles-and-permissions)

diff --git a/docs/platform/howto/byoc/assign-project-custom-cloud.md b/docs/platform/howto/byoc/assign-project-custom-cloud.md
@@ -10,9 +10,9 @@ import ConsoleLabel from "@site/src/components/non-swizzled/ConsoleIcons";
 Select your organizations, units, or project that can access and use your [custom cloud](/docs/platform/concepts/byoc).
 
 With the [BYOC feature enabled](/docs/platform/howto/byoc/enable-byoc), you can
-[create custom clouds](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+[create custom clouds](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
 organization. As a part of the
-[initial custom cloud's setup](/docs/platform/howto/byoc/create-custom-cloud),
+[initial custom cloud's setup](/docs/platform/howto/byoc/create-cloud/create-custom-cloud),
 you select in what projects you'll be able to use your new custom cloud to host Aiven
 services. You can update this setting any time later by following
 by following
@@ -27,15 +27,15 @@ cloud to be available.
 <Tabs groupId="group1">
 <TabItem value="1" label="Aiven Console" default>
 -   At least one
-    [custom cloud created](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+    [custom cloud created](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
     organization
 -   Access to the [Aiven Console](https://console.aiven.io/)
 -   [Organization admin](/docs/platform/concepts/permissions#organization-roles-and-permissions)
     role in your Aiven organization
 </TabItem>
 <TabItem value="2" label="Aiven CLI">
 -   At least one
-    [custom cloud created](/docs/platform/howto/byoc/create-custom-cloud) in your Aiven
+    [custom cloud created](/docs/platform/howto/byoc/create-cloud/create-custom-cloud) in your Aiven
     organization
 -   [Aiven CLI client](/docs/tools/cli) installed
 -   [Organization admin](/docs/platform/concepts/permissions#organization-roles-and-permissions)

diff --git a/...e-custom-cloud/create-aws-custom-cloud.md → ...c/create-cloud/create-aws-custom-cloud.md b/...e-custom-cloud/create-aws-custom-cloud.md → ...c/create-cloud/create-aws-custom-cloud.md
@@ -41,13 +41,13 @@ account so that Aiven can access it:
     role in your Aiven organization.
 -   You have Terraform installed.
 -   You have required
-    [IAM permissions](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#iam-permissions).
+    [IAM permissions](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#iam-permissions).
 
 ### IAM permissions
 
 You need cloud account credentials set up on your machine so that your user or role has
 required Terraform permissions
-[to integrate with your cloud provider](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#create-a-custom-cloud).
+[to integrate with your cloud provider](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#create-a-custom-cloud).
 
 <details><summary>
 Show permissions required for creating resources for bastion and workload networks
@@ -417,7 +417,7 @@ Create a custom cloud either in the Aiven Console or with the Aiven CLI.
 #### Generate an infrastructure template
 
 In this step, an IaC template is generated in the Terraform format. In
-[the next step](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#deploy-the-template),
+[the next step](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#deploy-the-template),
 you'll deploy this template in your AWS account to acquire Role ARN
 (Amazon Resource Name), which Aiven needs for accessing your AWS
 account.
@@ -482,7 +482,7 @@ In the **Create custom cloud** wizard:
 
 Your IaC Terraform template gets generated based on your inputs. You can
 view, copy, or download it. Now, you can use the template to
-[acquire Role ARN](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#deploy-the-template).
+[acquire Role ARN](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#deploy-the-template).
 
 #### Deploy the template
 
@@ -495,7 +495,7 @@ and run operations such as creating VMs for service nodes in your BYOC
 account.
 
 Use the
-[generated Terraform template](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#generate-an-infrastructure-template)
+[generated Terraform template](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#generate-an-infrastructure-template)
 to create your Role ARN by deploying the template in your AWS account.
 
 Continue working in the **Create custom cloud** wizard:
@@ -617,7 +617,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
    - `DEPLOYMENT_MODEL_NAME` with the type of [network architecture](/docs/platform/concepts/byoc#byoc-architecture)
      your custom cloud uses:
      - `standard_public` (public) model: The nodes have public IPs and can be configured
@@ -683,7 +683,7 @@ Your new custom cloud is ready to use only after its status changes to
          - `ORGANIZATION_ID` with the ID of your Aiven organization to
            connect with your own cloud account to create the custom cloud,
            for example `org123a456b789`. Get your `ORGANIZATION_ID`
-           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
          - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
            extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
            command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -701,7 +701,7 @@ Your new custom cloud is ready to use only after its status changes to
          - `ORGANIZATION_ID` with the ID of your Aiven organization to
            connect with your own cloud account to create the custom cloud,
            for example `org123a456b789`. Get your `ORGANIZATION_ID`
-           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
          - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
            extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
            command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -745,7 +745,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
    - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
      extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
      command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -769,7 +769,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
    - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
      extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
      command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -802,7 +802,7 @@ Your new custom cloud is ready to use only after its status changes to
     - `ORGANIZATION_ID` with the ID of your Aiven organization to
       connect with your own cloud account to create the custom cloud,
       for example `org123a456b789`. Get your `ORGANIZATION_ID`
-      [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud#prerequisites).
+      [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud#prerequisites).
     - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
       extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
       command, for example `018b6442-c602-42bc-b63d-438026133f60`.

diff --git a/...reate-custom-cloud/create-custom-cloud.md → .../byoc/create-cloud/create-custom-cloud.md b/...reate-custom-cloud/create-custom-cloud.md → .../byoc/create-cloud/create-custom-cloud.md
@@ -14,13 +14,13 @@ To create custom clouds in Aiven using self-service, select your cloud provider
 
 <GridContainer columns={2}>
      <Card
-      to="/docs/platform/howto/byoc/create-custom-cloud/create-aws-custom-cloud"
+      to="/docs/platform/howto/byoc/create-cloud/create-aws-custom-cloud"
       iconName="cloud"
       title="Amazon Web Services"
       description="Create an AWS-integrated custom cloud."
     />
     <Card
-      to="/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud"
+      to="/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud"
       iconName="googleLogo"
       title="Google Cloud"
       description="Create a Google-integrated custom cloud."

diff --git a/...ustom-cloud/create-google-custom-cloud.md → ...reate-cloud/create-google-custom-cloud.md b/...ustom-cloud/create-google-custom-cloud.md → ...reate-cloud/create-google-custom-cloud.md
@@ -52,13 +52,13 @@ account so that Aiven can access it:
     role in your Aiven organization.
 -   You have Terraform installed.
 -   You have required
-    [IAM permissions](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#iam-permissions).
+    [IAM permissions](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#iam-permissions).
 
 ### IAM permissions
 
 You need cloud account credentials set up on your machine so that your user or role has
 required Terraform permissions
-[to integrate with your cloud provider](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#create-a-custom-cloud).
+[to integrate with your cloud provider](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#create-a-custom-cloud).
 
 <details><summary>
 Show permissions needed by your service account that will run the Terraform script in your
@@ -98,7 +98,7 @@ Create a custom cloud either in the Aiven Console or with the Aiven CLI.
 #### Generate an infrastructure template
 
 In this step, an IaC template is generated in the Terraform format. In
-[the next step](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#deploy-the-template),
+[the next step](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#deploy-the-template),
 you'll deploy this template in your Google Cloud account to acquire a privilege-bearing
 service account (SA), which Aiven needs for accessing your Google Cloud account.
 
@@ -167,7 +167,7 @@ service account.
 #### Deploy the template
 
 Use the
-[generated Terraform template](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#generate-an-infrastructure-template)
+[generated Terraform template](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#generate-an-infrastructure-template)
 to create a privilege-bearing service account by deploying the template in your Google
 Cloud account.
 
@@ -288,7 +288,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
    - `DEPLOYMENT_MODEL_NAME` with the type of [network architecture](/docs/platform/concepts/byoc#byoc-architecture)
      your custom cloud uses:
      - `standard_public` (public) model: The nodes have public IPs and can be configured
@@ -354,7 +354,7 @@ Your new custom cloud is ready to use only after its status changes to
          - `ORGANIZATION_ID` with the ID of your Aiven organization to
            connect with your own cloud account to create the custom cloud,
            for example `org123a456b789`. Get your `ORGANIZATION_ID`
-           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
          - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
            extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
            command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -372,7 +372,7 @@ Your new custom cloud is ready to use only after its status changes to
          - `ORGANIZATION_ID` with the ID of your Aiven organization to
            connect with your own cloud account to create the custom cloud,
            for example `org123a456b789`. Get your `ORGANIZATION_ID`
-           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+           [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
          - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
            extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
            command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -417,7 +417,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
    - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
      extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
      command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -443,7 +443,7 @@ Your new custom cloud is ready to use only after its status changes to
    - `ORGANIZATION_ID` with the ID of your Aiven organization to
      connect with your own cloud account to create the custom cloud,
      for example `org123a456b789`. Get your `ORGANIZATION_ID`
-     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+     [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
    - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
      extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
      command, for example `018b6442-c602-42bc-b63d-438026133f60`.
@@ -476,7 +476,7 @@ Your new custom cloud is ready to use only after its status changes to
     - `ORGANIZATION_ID` with the ID of your Aiven organization to
       connect with your own cloud account to create the custom cloud,
       for example `org123a456b789`. Get your `ORGANIZATION_ID`
-      [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-custom-cloud/create-google-custom-cloud#prerequisites).
+      [from the Aiven Console or CLI](/docs/platform/howto/byoc/create-cloud/create-google-custom-cloud#prerequisites).
     - `CUSTOM_CLOUD_ID` with the identifier of your custom cloud, which you can
       extract from the output of the [avn byoc list](/docs/tools/cli/byoc#avn-byoc-list)
       command, for example `018b6442-c602-42bc-b63d-438026133f60`.