seto 3.0.3__tar.gz → 3.2.0__tar.gz

{seto-3.0.3 → seto-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: seto
-Version: 3.0.3
+Version: 3.2.0
 Summary: A Docker Swarm Deployment Manager
 License: Apache 2.0
 Keywords: docker,swarm,manager
@@ -21,8 +21,8 @@ Description-Content-Type: text/markdown
 # Ṣeto
 
 Ṣeto is a command-line tool designed to assist with setting up and managing
-shared storage volumes using NFS or GlusterFS drivers. It simplifies the process
-of configuring stack-based deployments, setting up manager and replica nodes,
+shared storage volumes using NFS driver. It simplifies the process of
+configuring stack-based deployments, setting up manager and replica nodes,
 creating and syncing shared volumes, and mounting and unmounting these volumes.
 
 ### Features
@@ -43,7 +43,7 @@ description of each subcommand and its options.
 These options are applicable to all subcommands:
 
 - `--stack`: Required. Specifies the stack name.
-- `--driver`: Required. Specifies the driver URI to use. Can be `nfs://username:password@hostname` or `gluster://username:password@hostname`.
+- `--driver`: Required. Specifies the driver URI to use. Example: `nfs://username:password@hostname`
 
 #### Subcommands
 

{seto-3.0.3 → seto-3.2.0}/README.md

@@ -1,8 +1,8 @@
 # Ṣeto
 
 Ṣeto is a command-line tool designed to assist with setting up and managing
-shared storage volumes using NFS or GlusterFS drivers. It simplifies the process
-of configuring stack-based deployments, setting up manager and replica nodes,
+shared storage volumes using NFS driver. It simplifies the process of
+configuring stack-based deployments, setting up manager and replica nodes,
 creating and syncing shared volumes, and mounting and unmounting these volumes.
 
 ### Features
@@ -23,7 +23,7 @@ description of each subcommand and its options.
 These options are applicable to all subcommands:
 
 - `--stack`: Required. Specifies the stack name.
-- `--driver`: Required. Specifies the driver URI to use. Can be `nfs://username:password@hostname` or `gluster://username:password@hostname`.
+- `--driver`: Required. Specifies the driver URI to use. Example: `nfs://username:password@hostname`
 
 #### Subcommands
 

{seto-3.0.3 → seto-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "seto"
-version = "3.0.3"
+version = "3.2.0"
 description = "A Docker Swarm Deployment Manager"
 keywords = ["docker", "swarm", "manager"]
 authors = ["Sébastien Demanou <demsking@gmail.com>"]

{seto-3.0.3 → seto-3.2.0}/seto/__main__.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -27,47 +27,53 @@ from .commands.setup import print_ssh_copy_id_commands
 from .commands.umount import execute_umount_volumes_command
 from .commands.volumes import execute_create_volumes_command
 from .core.shell import Setting
-from .drivers.gluster import GlusterDriver
 from .drivers.nfs import NFSDriver
 from .shells.local import LocalShell
 from .shells.remote import RemoteShell
 
-DriverType = type[str]
-ShellConnectionString = type[str]
+DriverType = str
+ShellConnectionString = str
 
 
-driver_shemes = ['nfs://', 'glusterfs://']
+driver_shemes = ['nfs://']
 driver_examples = [f'{sheme}username:password@hostname' for sheme in driver_shemes]
 DRIVER_EXAMPLES_STR = ' or '.join(driver_examples)
 
 
 def manager_type(value: str) -> tuple[DriverType, ShellConnectionString]:
   if not any(value.startswith(scheme) for scheme in driver_shemes):
-    raise argparse.ArgumentError('manager', f'{value} is not a valid manager ({DRIVER_EXAMPLES_STR})')
+    raise argparse.ArgumentError(
+      'manager',  # type: ignore
+      f'{value} is not a valid manager ({DRIVER_EXAMPLES_STR})',
+    )
 
-  return value.split('://')
+  driver_type, connection_string = value.split('://', 1)
+
+  return driver_type, connection_string
 
 
 def replica_type(value: str) -> list[Setting]:
   connection_strings = value.split(' ')
 
   try:
-    return [
-      Setting.from_connection_string(item.strip()) for item in connection_strings
-    ]
+    return [Setting.from_connection_string(item.strip()) for item in connection_strings]
   except Exception as exception:
-    raise argparse.ArgumentError('replica', f'{value} is not a replica value (username:password@hostname)') from exception
+    raise argparse.ArgumentError(
+      'replica',  # type: ignore
+      f'{value} is not a replica value (username:password@hostname)',
+    ) from exception
 
 
 def nodes_type(value: str) -> list[Setting]:
   connection_strings = value.split(' ')
 
   try:
-    return [
-      Setting.from_connection_string(item.strip()) for item in connection_strings
-    ]
+    return [Setting.from_connection_string(item.strip()) for item in connection_strings]
   except Exception as exception:
-    raise argparse.ArgumentError('nodes', f'{value} is not a nodes value (username:password@hostname)') from exception
+    raise argparse.ArgumentError(
+      'nodes',  # type: ignore
+      f'{value} is not a nodes value (username:password@hostname)',
+    ) from exception
 
 
 def main() -> None:
@@ -125,7 +131,9 @@ def main() -> None:
 
   #
   # Create Volumes command
-  create_volumes_parser = subparsers.add_parser('create-volumes', description='Create and sync shared volumes')
+  create_volumes_parser = subparsers.add_parser(
+    'create-volumes', description='Create and sync shared volumes'
+  )
   create_volumes_parser.set_defaults(func=execute_create_volumes_command)
   create_volumes_parser.add_argument(
     '--replica',
@@ -155,7 +163,9 @@ def main() -> None:
 
   #
   # Unmount Volumes command
-  umount_volumes_parser = subparsers.add_parser('unmount-volumes', description='Unmount shared volumes')
+  umount_volumes_parser = subparsers.add_parser(
+    'unmount-volumes', description='Unmount shared volumes'
+  )
   umount_volumes_parser.set_defaults(func=execute_umount_volumes_command)
   umount_volumes_parser.add_argument(
     '--clients',
@@ -167,7 +177,9 @@ def main() -> None:
 
   #
   # Config command
-  config_parser = subparsers.add_parser('config', description='Parse, resolve and render compose file in canonical format')
+  config_parser = subparsers.add_parser(
+    'config', description='Parse, resolve and render compose file in canonical format'
+  )
   config_parser.set_defaults(func=execute_config_command)
 
   config_parser.add_argument(
@@ -178,7 +190,9 @@ def main() -> None:
 
   #
   # Deploy command
-  deploy_parser = subparsers.add_parser('deploy', description='Deploy a new stack or update an existing stack')
+  deploy_parser = subparsers.add_parser(
+    'deploy', description='Deploy a new stack or update an existing stack'
+  )
   deploy_parser.set_defaults(func=execute_deploy_command)
 
   #
@@ -197,7 +211,7 @@ def main() -> None:
   driver_name, connection_string = args.manager
   setting = Setting.from_connection_string(connection_string)
   create_shell = LocalShell if setting.local else RemoteShell
-  create_driver = GlusterDriver if driver_name == 'gluster' else NFSDriver
+  create_driver = NFSDriver
   shell = create_shell(setting, args.key)
   driver = create_driver(args.stack, project=args.project, shell=shell)
 

{seto-3.0.3 → seto-3.2.0}/seto/commands/config.py

@@ -87,11 +87,11 @@ def resolve(
 
 def execute_config_command(args, driver: Driver) -> None:
   compose = resolve(args, driver)
-  compose_output = yaml.dump(compose)
+  compose_output = yaml.dump(compose) or '{}'
 
   if args.compose:
     command = f'docker compose -p {driver.stack_id} -f - config'
   else:
     command = 'docker stack config -c -'
 
-  Shell.pipe_exec(command, pipe_input=compose_output)
+  Shell.pipe_exec(command, pipe_input=str(compose_output))

{seto-3.0.3 → seto-3.2.0}/seto/commands/down.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -28,7 +28,7 @@ def execute_down_command(args, driver: Driver) -> None:
   setattr(args, 'compose', False)
 
   swarm = DockerSwarm(
-    stack=driver.stack_id,
+    # stack=driver.stack_id,
     client=client,
     driver=driver,
     config=resolve(args, driver),
@@ -42,7 +42,7 @@ def execute_down_command(args, driver: Driver) -> None:
 
   if config['services']:
     compose = DockerCompose(
-      stack=driver.stack_id,
+      # stack=driver.stack_id,
       client=client,
       driver=driver,
       config=config,

{seto-3.0.3 → seto-3.2.0}/seto/core/docker.py

@@ -45,8 +45,9 @@ class Docker:
   @property
   def external_networks(self) -> list[str]:
     return [
-      item.attrs['Name'] for item in self.client.networks.list()
-      if item.attrs['Name'].startswith(self.driver.stack_id)
+      item.attrs['Name']
+      for item in self.client.networks.list()
+      if item.attrs and item.attrs['Name'].startswith(self.driver.stack_id)
     ]
 
   @staticmethod
@@ -57,7 +58,7 @@ class Docker:
     pipe_input: str,
   ) -> None:
     ssh_command = f"ssh {Driver.setouser}@{hostname} '{command}'"
-    return Shell.pipe_exec(ssh_command, pipe_input=pipe_input)
+    return Shell.pipe_exec(ssh_command, pipe_input=pipe_input)  # type: ignore
 
   def build(self) -> None:
     Shell.pipe_exec(
@@ -99,8 +100,8 @@ class DockerCompose(Docker):
     return self.config.get('x-placement-hostname', None)
 
   @property
-  def placement(self) -> str | None:
-    return self.config.get('x-placement', None)
+  def placement(self) -> str:
+    return self.config.get('x-placement', '')
 
   @property
   def current_hostname(self) -> str:
@@ -108,7 +109,7 @@ class DockerCompose(Docker):
 
   @property
   @functools.lru_cache(maxsize=128)
-  def node_hostname(self) -> str | None:
+  def node_hostname(self) -> str:
     if self.placement_hostname:
       return self.placement_hostname
 
@@ -119,7 +120,7 @@ class DockerCompose(Docker):
     value = f'{label_value}'.strip()
 
     for node in nodes:
-      if node.attrs['Spec']['Labels'].get(label_key) == value:
+      if node.attrs and node.attrs['Spec']['Labels'].get(label_key) == value:
         return node.attrs['Description']['Hostname']
 
     raise ValueError(f'Unable to found node for placement "{self.placement}"')

{seto-3.0.3 → seto-3.2.0}/seto/core/driver.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -30,7 +30,7 @@ class Driver:
     project: str,
     shell: Shell,
   ) -> None:
-    self.stack = stack
+    self.stack: str | None = stack
     self.project = project
     self.shell = shell
 
@@ -48,7 +48,7 @@ class Driver:
 
   @property
   def sheme(self) -> str:
-    raise f'{self.slug}://'
+    return f'{self.slug}://'
 
   @property
   def driver_name(self) -> str:
@@ -92,7 +92,10 @@ class Driver:
       node.run(f'touch {authorized_keys_file}', quiet=True)
       authorized_keys = node.file(authorized_keys_file)
 
-      authorized_keys.append(node.ssh_pub_key)
+      # Append the SSH public key to authorized_keys file
+      if node.ssh_pub_key:
+        authorized_keys.append(node.ssh_pub_key)
+
       authorized_keys.chown(self.setouser, self.setouser)
       authorized_keys.chmod('600')
 
@@ -132,7 +135,7 @@ class Driver:
   ) -> None:
     raise NotImplementedError()
 
-  def mount_volumes(self, *, clients: list[str], volumes: list[Volume]) -> None:
+  def mount_volumes(self, *, clients: list[Setting], volumes: list[Volume]) -> None:
     if len(volumes) > 0:
       for node_setting in clients:
         node = Driver.get_shell(node_setting, self.shell.key_file_path)
@@ -162,7 +165,7 @@ class Driver:
   def mount(self, node: Shell, storage: str, *, device: str, fstab: File) -> None:
     raise NotImplementedError()
 
-  def umount_volumes(self, *, clients: list[str], volumes: list[Volume]) -> None:
+  def umount_volumes(self, *, clients: list[Setting], volumes: list[Volume]) -> None:
     if len(volumes) > 0:
       for node_setting in clients:
         node = Driver.get_shell(node_setting, self.shell.key_file_path)
@@ -173,7 +176,7 @@ class Driver:
   def umount_node_volumes(self, node: Shell, volumes: list[Volume]) -> None:
     for volume in volumes:
       print(f'\nUnmounting volume {node.hostname}:{self.mount_point(volume.mount_folder)}')
-      self.umount(node, volume)
+      self.umount(node, volume.mount_folder)
 
   def umount(self, node: Shell, device: str) -> None:
     node.run(f'umount {device}')
@@ -181,6 +184,6 @@ class Driver:
   def resolve_compose_volume(self, volume: Volume) -> dict:
     raise NotImplementedError()
 
-  def terminate(self):
+  def terminate(self) -> None:
     # Close the SSH connection
     self.shell.close()

{seto-3.0.3 → seto-3.2.0}/seto/core/network.py

@@ -17,33 +17,31 @@ import os
 
 import yaml
 
+
+NETWORK_CONFIG = {
+  'ipam': {
+    'driver': 'default',
+  },
+}
+
 GLOBAL_NETWORKS = {
   'seto-cloud-public': {
     'name': 'seto-cloud-public',
     'driver': 'overlay',
     'attachable': True,
+    **NETWORK_CONFIG,
   },
   'seto-cloud-edge': {
     'name': 'seto-cloud-edge',
     'driver': 'overlay',
     'attachable': True,
-    'ipam': {
-      'config': [
-        {'subnet': '172.20.0.0/20'},
-        {'subnet': 'fd00:3984:3989::/64'},
-      ],
-    },
+    **NETWORK_CONFIG,
   },
   'seto-http-provider': {
     'name': 'seto-http-provider',
     'driver': 'overlay',
     'attachable': True,
-    'ipam': {
-      'config': [
-        {'subnet': '172.20.0.0/20'},
-        {'subnet': 'fd00:3984:3989::/64'},
-      ],
-    },
+    **NETWORK_CONFIG,
   },
 }
 
@@ -53,7 +51,8 @@ def get_global_external_networks() -> dict:
     shortname: {
       'name': network['name'],
       'external': True,
-    } for shortname, network in GLOBAL_NETWORKS.items()
+    }
+    for shortname, network in GLOBAL_NETWORKS.items()
   }
 
 
@@ -67,7 +66,7 @@ def resolve_networks(
   for network_file in networks_files:
     with open(network_file, encoding='utf-8') as file:
       network_key = os.path.splitext(os.path.basename(network_file))[0]
-      network_data = yaml.safe_load(file)
+      network_data: dict = yaml.safe_load(file) or {}  # type: ignore
       network_name = network_data.get('name', f'{project}_{network_key}')
       merged_data[network_key] = network_data
 
@@ -75,6 +74,8 @@ def resolve_networks(
         network_data.clear()
 
         network_data['external'] = True
+      else:
+        network_data.update(NETWORK_CONFIG)
 
       network_data['name'] = network_name
 

{seto-3.0.3 → seto-3.2.0}/seto/core/parser.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -79,9 +79,13 @@ def parse_local_volumes(
     image_name = f'{stack}-{service_name}'.replace('_', '-')
     service_dockerfile_name = f'{image_name}.dockerfile'
     service_dockerfile_file = os.path.join('images', service_dockerfile_name)
-    service_dockerfile_definition = [
-      f'FROM {service["image"]}',
-    ] + [f'COPY {source} {target}' for source, target in local_volumes] + ['']
+    service_dockerfile_definition = (
+      [
+        f'FROM {service["image"]}',
+      ]
+      + [f'COPY {source} {target}' for source, target in local_volumes]
+      + ['']
+    )
     service_dockerfile = '\n'.join(service_dockerfile_definition)
     service_dockerfile = resolve_env_vars(service_dockerfile)
 
@@ -235,11 +239,15 @@ def parse_service_configs(
 
       if source.startswith('./') or source.startswith('../'):
         if os.path.isfile(source):
-          config_name = re.sub(r'_{2,}', '_', f"{service_name}_{source.replace('/', '_').replace('.', '_')}".replace('-', '_'))
+          config_name = re.sub(
+            r'_{2,}',
+            '_',
+            f"{service_name}_{source.replace('/', '_').replace('.', '_')}".replace('-', '_'),
+          )
 
           if inject:
             with open(source, encoding='utf-8') as config:
-              configs[config_name] = {
+              configs[config_name] = {  # type: ignore
                 'content': config.read(),
               }
           else:
@@ -247,11 +255,13 @@ def parse_service_configs(
               'file': source,
             }
 
-          service_configs.append({
-            'source': config_name,
-            'target': target,
-            'mode': parse_permission_mode(mode),
-          })
+          service_configs.append(
+            {
+              'source': config_name,
+              'target': target,
+              'mode': parse_permission_mode(mode),
+            }
+          )
 
           continue
 
@@ -274,7 +284,7 @@ def resolve_env_vars(content: str) -> str:
   return output.stdout
 
 
-def parse_compose_file(compose_file: str, resolve_vars=False) -> tuple[dict, str, str]:
+def parse_compose_file(compose_file: str, resolve_vars=False) -> tuple[dict, str]:
   compose_file = os.path.realpath(compose_file)
 
   with open(compose_file, encoding='utf-8') as file:
@@ -285,7 +295,7 @@ def parse_compose_file(compose_file: str, resolve_vars=False) -> tuple[dict, str
 
     compose_data = yaml.safe_load(compose_content)
 
-  return compose_data, compose_file
+  return compose_data, compose_file  # type: ignore
 
 
 def parse_services(
@@ -295,13 +305,13 @@ def parse_services(
   execute: Callable[[dict, list], None] | None = None,
   mode: list[ResolveMode] | None = None,
   inject: bool = False,
-) -> tuple[dict, list]:
+) -> tuple[list, list]:
   services_files = glob.glob(os.path.join(stack, '*.yaml'))
   output_resolved_compose_data = []
   output_volumes = []
 
   for service_file in services_files:
-    resolve_vars = mode and 'compose' in mode
+    resolve_vars = isinstance(mode, list) and 'compose' in mode
     compose_data, _ = parse_compose_file(service_file, resolve_vars)
     x_mode = compose_data.get('x-mode', 'swarm')
 

{seto-3.0.3 → seto-3.2.0}/seto/core/shell.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -49,6 +49,12 @@ class Setting:
       node_host = client_user
       client_user = 'root'
 
+    if not node_host:
+      raise ValueError('Unable to determine hostname from connection string')
+
+    if not client_user:
+      raise ValueError('Unable to determine username from connection string')
+
     username, password = tuple((client_user.split(':') + [None, None])[0:2])
     node_ip = resolve_hostname(node_host)
 
@@ -86,7 +92,7 @@ class File:
     else:
       self.shell.run(f'chown {owner} {self.filename}', quiet=True)
 
-  def chmod(self, mode: str):
+  def chmod(self, mode: str | int):
     if 'letsencrypt' in self.filename:
       mode = 600
 
@@ -104,7 +110,7 @@ class Shell:
     return self.setting.hostname
 
   @property
-  def username(self) -> str:
+  def username(self) -> str | None:
     return self.setting.username
 
   @property
@@ -113,9 +119,11 @@ class Shell:
 
   @property
   @lru_cache
-  def ssh_pub_key(self) -> str:
-    with open(self.pub_key_file_path, encoding='utf-8') as key_file:
-      return key_file.read()
+  def ssh_pub_key(self) -> str | None:
+    if self.pub_key_file_path:
+      with open(self.pub_key_file_path, encoding='utf-8') as key_file:
+        return key_file.read()
+    return None
 
   def connect(self):
     raise NotImplementedError()
@@ -135,7 +143,7 @@ class Shell:
       stderr=subprocess.PIPE,
       text=True,
       shell=True,
-      env={**(env_vars or {}), **dict(subprocess.os.environ)},
+      env={**(env_vars or {}), **dict(subprocess.os.environ)},  # type: ignore
     )
 
     standard_output, standard_error = process.communicate(**kwargs)
@@ -155,16 +163,18 @@ class Shell:
     with StringIO(pipe_input) as pipe:
       return Shell.exec(command, stdout=stdout, env_vars=env_vars, input=pipe.read())
 
-  def install(self, package_name: str, *, user='nobody', group='nogroup') -> None:
+  def install(self, package_name: str, *, user='nobody', group='nogroup') -> bool:
     result = self.run(f'dpkg -l | grep {package_name}', quiet=True, stdout=False)
 
     if package_name not in result:
-      self.run(f'apt-get install -y --quiet {package_name}', quiet=True)
+      self.run(
+        f'DEBIAN_FRONTEND=noninteractive apt-get install -y --quiet {package_name}', quiet=True
+      )
       return True
 
     return False
 
-  def mkdir(self, path: str, *, user='nobody', group='nogroup', mode: str = 'g+w') -> None:
+  def mkdir(self, path: str, *, user='nobody', group='nogroup', mode: str | int = 'g+w') -> None:
     try:
       self.run(f'ls {path}', quiet=True, stderr=True)
     except Exception:

{seto-3.0.3 → seto-3.2.0}/seto/core/traefik.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -37,10 +37,10 @@ def deep_set(dct: dict[str, Any], keys: str, value: Any):
       # Extend the list if the index doesn't exist yet
       while len(current) <= key:
         current.append({})
-      current = current[key]
+      current = current[key]  # type: ignore
     else:
       if isinstance(current, list):  # Handle case where current is mistakenly a list
-        current = current[-1]
+        current = current[-1]  # type: ignore
       current = current.setdefault(key, {})
 
   # Handle the last key separately

{seto-3.0.3 → seto-3.2.0}/seto/shells/remote.py

@@ -1,4 +1,4 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
+# Copyright 2024-2025 Sébastien Demanou. All Rights Reserved.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -45,7 +45,10 @@ class RemoteShell(Shell):
       pkey=private_key,
     )
 
-    self._fs = self.ssh.open_sftp()
+    fd = self.ssh.open_sftp()
+
+    if fd:
+      self._fs = fd
 
   def run(
     self,

seto-3.0.3/seto/drivers/gluster.py

@@ -1,146 +0,0 @@
-# Copyright 2024 Sébastien Demanou. All Rights Reserved.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-# ==============================================================================
-from ..core.driver import Driver
-from ..core.shell import File
-from ..core.shell import Setting
-from ..core.shell import Shell
-from ..core.volume import Volume
-
-
-class GlusterDriver(Driver):
-  @property
-  def slug(self) -> str:
-    return 'glusterfs'
-
-  @property
-  def driver_name(self) -> str:
-    return 'GlusterFS'
-
-  @staticmethod
-  def install_plugin(shell: Shell, force: bool = False) -> None:
-    """
-    Install GlusterFS Volume Plugin.
-
-    Images:
-      - https://registry.hub.docker.com/r/mochoa/glusterfs-volume-plugin
-      - https://registry.hub.docker.com/r/mochoa/glusterfs-volume-plugin-aarch64
-    """
-    uname = shell.run('uname -a', stdout=False)
-    plugins_list = shell.run(
-      cmd='docker plugin ls | grep glusterfs',
-      stdout=False,
-      quiet=True,
-    )
-
-    if 'glusterfs' in plugins_list:
-      if 'true' in plugins_list and not force:
-        # Skip install if already installed
-        return
-
-      shell.run('docker plugin disable glusterfs')
-      shell.run('docker plugin rm glusterfs')
-
-    if 'aarch64' in uname:
-      image = 'mochoa/glusterfs-volume-plugin-aarch64'
-    else:
-      image = 'mochoa/glusterfs-volume-plugin'
-
-    shell.run(f'docker plugin install --alias glusterfs {image} --grant-all-permissions --disable')
-    shell.run('docker plugin enable glusterfs')
-    shell.run('docker plugin ls')
-
-  @staticmethod
-  def install_server(shell: Shell) -> None:
-    # Add the user to the nogroup group
-    shell.run(f'usermod -aG nogroup {shell.username}')
-
-    fresh_installed = shell.install('glusterfs-server')
-
-    if fresh_installed:
-      shell.run('systemctl start glusterd')
-      shell.run('systemctl enable glusterd')
-
-  def setup_manager(self, replica: list[Setting], force: bool = False) -> None:
-    super().setup_manager(replica, force)
-
-    # Add the user to the nogroup group
-    GlusterDriver.install_server(self.shell)
-    GlusterDriver.install_plugin(self.shell, force)
-
-    for node_setting in replica:
-      shell = Driver.get_shell(node_setting, self.shell.key_file_path)
-
-      shell.connect()
-      GlusterDriver.install_server(shell)
-      GlusterDriver.install_plugin(shell, force)
-      shell.close()
-
-    for node_setting in replica:
-      self.shell.run(f'gluster peer probe {node_setting.hostname}')
-
-    self.shell.run('gluster peer status')
-    self.shell.run('gluster pool list')
-
-  def apply_manager_changes(self) -> None:
-    pass
-
-  def setup_node(self, shell: Shell, force: bool = False) -> None:
-    shell.install('glusterfs-client')
-    GlusterDriver.install_plugin(shell, force)
-
-  def create_volumes(
-    self,
-    *,
-    replica: list[Setting],
-    volumes: list[Volume],
-    force: bool = False,
-  ) -> None:
-    self.shell.mkdir(self.brick)
-
-    replica_count = len(replica)
-    replica_items = [f'{item.hostname}:{self.brick}' for item in replica]
-    replica_items_str = ' '.join(replica_items)
-
-    for volume in volumes:
-      self.shell.run(f'gluster volume create {volume.name} replica {replica_count} transport tcp {replica_items_str} force')
-      self.shell.run(f'gluster volume start {volume.name}')
-
-    self.shell.run('gluster volume info')
-
-    for volume in volumes:
-      print(f'Initializing volume {volume.name}...')
-      self.server.copy_volume(volume, self.brick)
-
-  def mount_volume(self, node: Shell, volume: Volume, fstab: File) -> None:
-    """
-    Mount the given volume on the given node.
-
-    See https://docs.gluster.org/en/latest/Administrator-Guide/Setting-Up-Clients/#mounting-volumes
-    """
-    volume_id = f'{self.shell.setting.ip}:/{volume.name}'
-
-    node.mkdir(volume.device)
-    node.run(f'mount -t glusterfs {volume_id} {volume.device}')
-    node.run(f'df -h {volume.device}')
-    fstab.append(f'{volume_id}\t{volume.device}\tglusterfs\tdefaults,_netdev 0 0')
-
-  def resolve_compose_volume(self, volume: Volume) -> dict:
-    return {
-      'name': volume.name + volume.mount_point,
-      'driver': 'glusterfs',
-      'driver_opts': {
-        'servers': self.shell.hostname,
-      },
-    }