Skip to main content
Connect file storage to a Managed Kubernetes cluster in another pool

Connect file storage to a Managed Kubernetes cluster in another pool

If you plan to use file storage to store backups, to improve fault tolerance, we recommend creating a Managed Kubernetes storage and cluster in poolahs from different availability zones or regions. If the file storage and the Managed Kubernetes cluster are in different pools, you must configure private network connectivity at the L3 level to connect the storage via a global router.

  1. Create a global router.

  2. Connect the network and subnet for the Managed Kubernetes cluster to the global router.

  3. Connect the network and subnet for the file storage to the global router.

  4. Assign an IP address on the Managed Kubernetes cluster node.

  5. Write routes on the node of the Managed Kubernetes cluster. You can only add routes through technical support.

  6. Create file storage.

  7. Mount the file storage to the Managed Kubernetes cluster.

Check it out example of connecting file storage to a Managed Kubernetes cluster in another pool.

If you need to increase disk space with file storage, we recommend creating the storage in the same pool as the Managed Kubernetes cluster. Read more in the instructions Connect file storage to a Managed Kubernetes cluster in a single pool.

Example of connecting file storage to a Managed Kubernetes cluster⁠

For example, you need to connect file storage in pool ru-2 to a Managed Kubernetes cluster in pool ru-8.

  1. Create a global router.

  2. Connect two private networks to the global router — 192.168.0.0/29 gateway 192.168.0.1 for the ru-8 pool and 172.16.0.0/29 gateway 172.16.0.1 for pool ru-2.

  3. Assign an address from a subnet 192.168.0.0/29 on a node of a Managed Kubernetes cluster, e.g. 192.168.0.2.

  4. Write a route on the Managed Kubernetes cluster node in the ru-8 pool — to the subnetwork 172.16.0.0/29 through the gateway 192.168.0.1.

  5. Create file storage on a subnetwork 172.16.0.0/29.

  6. Mount the file storage to the Managed Kubernetes cluster.

1. Create a global router⁠

  1. В control panels from the top menu, press Products and select Global router.
  2. Click Create a router. Each account is set limit to five global routers.
  3. Enter the name of the router.
  4. Click Create.
  5. If the router was created with status ERROR or hovered in one of the statuses, file a ticket.

2. Connect the network and subnet for the Managed Kubernetes cluster to the router⁠

For your information

If the cloud platform network is connected to a global router, you can only manage it on the global router page.

You need to create a global router network and subnet to that project and cloud platform pool where the Managed Kubernetes cluster is created.

You can connect a new network to the router or an existing network if it is not already connected to any of the account's global routers.

  1. В control panels from the top menu, press Products and select Global router.

  2. Open the router page → tab Networks.

  3. Click Create a network.

  4. Enter a network name, this will only be used in the control panel.

  5. Select a service Cloud platform.

  6. Select pool which has a Managed Kubernetes cluster.

  7. Select project which has a Managed Kubernetes cluster.

  8. Enter the subnet name — this will only be used in the control panel.

  9. Enter the CIDR — IP address and subnet mask. The subnet must meet the conditions:

    • belong to the RFC 1918 private address range: 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16;
    • have a size of at least /29, as three addresses will be occupied by Servercore network equipment;
    • Do not overlap with other subnets added to this router: The IP addresses of each subnet on the router must not overlap with the IP addresses of other subnets on the router;
    • If Managed Kubernetes nodes will be included in the global router network, the subnet must not overlap with the ranges 10.250.0.0/16, 10.10.0.0/16 и 10.96.0.0/12. These subnets participate in the internal addressing of Managed Kubernetes, their use may cause conflicts in the global router network.

  10. Enter the gateway IP or leave the first address from the subnet assigned by default. Do not assign this address to your devices to avoid disrupting the network.

  11. Enter service IPs or leave the last addresses from the subnet assigned by default. Do not assign these addresses to your devices to avoid disrupting the network.

  12. Click Create a network.

  13. Optional: check the network topology on the global router. В control panels from the top menu, press Products and select Global router. Open the page of the desired router and click Network map.

3. Connect a network and subnet to the router for file storage⁠

For your information

If the cloud platform network is connected to a global router, you can only manage it on the global router page.

You need to create a global router network and subnet to that project and cloud platform pool where the file storage will be created in the future.

You can connect a new network to the router or an existing network if it is not already connected to any of the account's global routers.

  1. В control panels from the top menu, press Products and select Global router.

  2. Open the router page → tab Networks.

  3. Click Create a network.

  4. Enter a network name, this will only be used in the control panel.

  5. Select a service Cloud platform.

  6. Select pool The file storage will be created in this folder.

  7. Select project The file storage will be created in this folder.

  8. Enter the subnet name — this will only be used in the control panel.

  9. Enter the CIDR — IP address and subnet mask. The subnet must meet the conditions:

    • belong to the RFC 1918 private address range: 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16;
    • have a size of at least /29, as three addresses will be occupied by Servercore network equipment;
    • Do not overlap with other subnets added to this router: The IP addresses of each subnet on the router must not overlap with the IP addresses of other subnets on the router;
    • If Managed Kubernetes nodes will be included in the global router network, the subnet must not overlap with the ranges 10.250.0.0/16, 10.10.0.0/16 и 10.96.0.0/12. These subnets participate in the internal addressing of Managed Kubernetes, their use may cause conflicts in the global router network.

  10. Enter the gateway IP or leave the first address from the subnet assigned by default. Do not assign this address to your devices to avoid disrupting the network.

  11. Enter service IPs or leave the last addresses from the subnet assigned by default. Do not assign these addresses to your devices to avoid disrupting the network.

  12. Click Create a network.

  13. Optional: check the network topology on the global router. В control panels from the top menu, press Products and select Global router. Open the router page and click Network map.

4. Assign an IP address to a Managed Kubernetes cluster node⁠

Configure a local port on the Managed Kubernetes cluster node that is included in the global router network. On the port, assign an IP address from the subnet you created on the global router for the corresponding pool.

  1. Add a Managed Kubernetes cluster node to the created subnet of the global router. If you do not already have a Managed Kubernetes cluster, create one. When creating it, select the subnet of the global router as the subnet.

  2. Apply changes depending on the parameter Apply the changes en bloc Configuring ports. The value of the parameter can be viewed in control panels in the top menu Products → Cloud servers → cloud server page → tab Ports:

    • When the server reboots — programmatically reboot the node or manually make changes to the network configuration file on the node;
    • Manually in the network configuration file on the server — manually make changes to the network configuration file on the node.

5. Write routes on the Managed Kubernetes cluster node⁠

If you have created a new Managed Kubernetes cluster and added a node to an existing global router network, you do not need to specify routes. In this case, the node will be immediately available to other devices on the network.

If you are adding an existing node to the global router network, it must have static routes to all subnets with which you want connectivity. To do this file a ticket.

6. Create file storage⁠

  1. В control panels from the top menu, press Products and select File storage.

  2. Click Create storage.

  3. Enter a new storage name or leave the name that is automatically created.

  4. Select region and pool segment where the storage will be created.

    If you need to increase disk space with file storage, select a pool segment from the pool that hosts the cloud server or Managed Kubernetes cluster.

    If you plan to use storage to store backups, we recommend selecting a pool segment from a different availability zone or region to improve fault tolerance.

  5. Fill in the blocks:

  6. Check out the price of file storage.

  7. Click Create.

Subnetwork⁠

  1. Select the private subnet where the storage will be located. The type of subnet depends on what you want to connect the storage to:

    • cloud private subnet — the storage will be available to Managed Kubernetes cloud servers and clusters only in the pool you selected in the previous step. To connect the storage you will only need to mount it;
    • global router subnet — the storage will be available for dedicated servers, as well as cloud servers and Managed Kubernetes clusters that are located in other pools. To connect the storage, you need to configure network connectivity between the server or cluster and the storage through the global router. See examples of how to configure network connectivity in the instructions in the section Connect file storage.

    Once the repository is created, the subnet cannot be changed.

  2. Enter a private IP address for the vault or leave the first available address from the subnet assigned by default. Once the storage is created, the IP address cannot be changed.

Settings⁠

  1. Select file storage type:

    • HDD Basic
    • SSD Universal
    • SSD Fast

    Once created, the storage type cannot be changed.

  2. Specify the storage size: from 50 GB to 50 TB. Once created, you can expand file storage but you can't reduce it.

  3. Select a protocol:

    • NFSv4 — for connecting storage to servers running Linux and other Unix systems;
    • CIFS SMBv3 — for connecting the storage to Windows servers.

    Once the repository is created, the protocol cannot be changed.

Access rules⁠

  1. Configure the file storage access rules:

    • available to all — the storage will be available to any IP address of the private subnet in which it is created;
    • access restricted — the storage will be available only to specific IP addresses or private subnets. If you create a file storage without rules, access will be restricted to all IP addresses.

  2. If you have selected the option Access is restricted, press Add rule.

  3. Enter the IP address or CIDR of the private subnet, select the access level.

    After creating the storage you can change the access rules, for this purpose you can configure new access rules.

7. Mount file storage to a Managed Kubernetes cluster⁠

The mount process depends on the file storage protocol: NFSv4 or CIFS SMBv3.

  1. Create PersistentVolume.

  2. Create PersistentVolumeClaim.

  3. Add file storage to the container.

1. Create PersistentVolume⁠

  1. Connect to a Managed Kubernetes cluster.

  2. Create a yaml file with a manifest for the PersistentVolume object:

    apiVersion: v1
    kind: PersistentVolume
    metadata:
      name: pv_name
    spec:
      storageClassName: storageclass_name
      capacity:
        storage: <storage_size>
      accessModes:
        - ReadWriteMany
      nfs:
        path: /shares/share-<mountpoint_uuid>
        server: <filestorage_ip_address>

    Specify:

    • <storage_size> — PersistentVolume size in GB (file storage size), e.g. 100 Gi. The limit is from 50 GB to 50 TB;
    • <mountpoint_uuid> — The ID of the mount point. You can look in control panels: from the top menu, press Products → File storage → storage page → block Connection → tab GNU/Linux;
    • <filestorage_ip_address> — The IP address of the file storage. You can look in control panels: from the top menu, press Products → File storage → storage page → tab Settings → field IP.

  3. Apply the manifest:

    kubectl apply -f <persistent_volume.yaml>

    Specify <persistent_volume.yaml> — the name of the yaml file with the manifest to create the PersistentVolume.

  4. Make sure that a PersistentVolume object is created:

    kubectl get pv

2. Create a PersistentVolumeClaim⁠

  1. Create a yaml file with a manifest for the PersistentVolumeClaim object:

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: pvc_name
    spec:
      storageClassName: storageclass_name
      accessModes:
        - ReadWriteMany
      resources:
        requests:
          storage: <storage_size>

    Specify <storage_size> — PersistentVolume (file storage) size in GB, e.g. 100 Gi. The limit is from 50 GB to 50 TB.

  2. Apply the manifest:

    kubectl apply -f <persistent_volume_claim.yaml>

    Specify <persistent_volume_claim.yaml> — the name of the yaml file with the manifest to create the PersistentVolumeClaim.

  3. Ensure that a PersistentVolumeClaim object is created:

    kubectl get pvc

3. Add storage to a container⁠

  1. Create a yaml file with a manifest for the Deployment object:

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: filestorage_deployment_name
      labels:
        project: filestorage_deployment_name
    spec:
      replicas: 2
      selector:
        matchLabels:
          project: filestorage_project_name
      template:
        metadata:
          labels:
            project: filestorage_project_name
        spec:
          volumes:
            - name: volume_name
              persistentVolumeClaim:
                claimName: pvc_name
          containers:
            - name: container-nginx
              image: nginx:stable-alpine
              ports:
                - containerPort: 80
                  name: "http-server"
              volumeMounts:
                - name: volume_name
                  mountPath: <mount_path>

    Specify <mount_path> — path to the folder inside the container to which the file storage will be mounted.

  2. Apply the manifest:

    kubectl apply -f <deployment.yaml>

    Specify <deployment.yaml> — the name of the yaml file with the manifest to create the Deployment.