refactor: support muting original healthcheck in docker container

Signed-off-by: thxCode <thxcode0824@gmail.com>

Author: thxCode

gpustack_runtime/cmds/deployer.py

@@ -110,8 +110,7 @@ def register(parser: _SubParsersAction):
         deploy_parser.add_argument(
             "--port",
             type=int,
-            help="port to expose (default: 80)",
-            default=80,
+            help="port to expose",
         )
 
         deploy_parser.add_argument(
@@ -210,13 +209,15 @@ def run(self):
         )
         if self.extra_args:
             execution.command = self.extra_args
-        ports = [
-            ContainerPort(
-                internal=self.port,
-            ),
-        ]
+        ports = None
+        if self.port:
+            ports = [
+                ContainerPort(
+                    internal=self.port,
+                ),
+            ]
         checks = None
-        if self.check:
+        if self.check and self.port:
             checks = [
                 ContainerCheck(
                     delay=60,
@@ -318,8 +319,7 @@ def register(parser: _SubParsersAction):
         deploy_parser.add_argument(
             "--port",
             type=int,
-            help="port to expose (default: 80)",
-            default=80,
+            help="port to expose",
         )
 
         deploy_parser.add_argument(
@@ -417,13 +417,15 @@ def run(self):
         )
         if self.extra_args:
             execution.command = self.extra_args
-        ports = [
-            ContainerPort(
-                internal=self.port,
-            ),
-        ]
+        ports = None
+        if self.port:
+            ports = [
+                ContainerPort(
+                    internal=self.port,
+                ),
+            ]
         checks = None
-        if self.check:
+        if self.check and self.port:
             checks = [
                 ContainerCheck(
                     delay=60,

gpustack_runtime/deployer/docker.py

@@ -958,6 +958,13 @@ def _create_containers(
                 ephemeral_volume_name_mapping,
             )
 
+            if envs.GPUSTACK_RUNTIME_DOCKER_MUTE_ORIGINAL_HEALTHCHECK:
+                create_options["healthcheck"] = {
+                    "test": [
+                        "NONE",
+                    ],
+                }
+
             # Parameterize health checks.
             # Since Docker only support one complete check,
             # we always pick the first check as target.

gpustack_runtime/envs.py

@@ -130,6 +130,10 @@
     """
     Directory for storing ephemeral files for Docker.
     """
+    GPUSTACK_RUNTIME_DOCKER_MUTE_ORIGINAL_HEALTHCHECK: bool = True
+    """
+    Mute the original healthcheck of the container.
+    """
     ## Kubernetes
     GPUSTACK_RUNTIME_KUBERNETES_NODE_NAME: str | None = None
     """
@@ -266,6 +270,9 @@
             expand_path("~/.cache/gpustack-runtime"),
         ),
     ),
+    "GPUSTACK_RUNTIME_DOCKER_MUTE_ORIGINAL_HEALTHCHECK": lambda: to_bool(
+        getenv("GPUSTACK_RUNTIME_DOCKER_MUTE_ORIGINAL_HEALTHCHECK", "1"),
+    ),
     "GPUSTACK_RUNTIME_KUBERNETES_NODE_NAME": lambda: getenv(
         "GPUSTACK_RUNTIME_KUBERNETES_NODE_NAME",
         None,

pack/Dockerfile.dummy

@@ -0,0 +1,34 @@
+# Dockerfile to build testing image.
+#
+FROM nginx:1.29.3-alpine3.22-perl
+
+RUN <<EOF
+    mkdir -p /etc/nginx/templates/
+    cat <<EOT > /etc/nginx/templates/default.conf.template
+server {
+    listen       \${NGINX_PORT};
+    server_name  \${NGINX_HOST};
+
+    location / {
+        root   /usr/share/nginx/html;
+        index  index.html index.htm;
+    }
+
+    error_page   500 502 503 504  /50x.html;
+    location = /50x.html {
+        root   /usr/share/nginx/html;
+    }
+}
+EOT
+EOF
+ENV NGINX_ENVSUBST_TEMPLATE_DIR=/etc/nginx/templates \
+    NGINX_ENVSUBST_TEMPLATE_SUFFIX=.template \
+    NGINX_ENVSUBST_OUTPUT_DIR=/etc/nginx/conf.d \
+    NGINX_PORT=80 \
+    NGINX_HOST=localhost
+
+HEALTHCHECK --interval=30s --timeout=30s --start-period=10s --retries=5 \
+    CMD curl --fail http://${NGINX_HOST}:${NGINX_PORT}/ || exit 1
+
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["nginx", "-g", "daemon off;"]