feat: implement force push functionality in ImageSpec

flytekit/image_spec/image_spec.py

@@ -44,6 +44,7 @@ class ImageSpec:
         pip_index: Specify the custom pip index url
         registry_config: Specify the path to a JSON registry config file
         commands: Command to run during the building process
+        _is_force_push: forcefully pushed to the registry
     """
 
     name: str = "flytekit"
@@ -67,6 +68,7 @@ class ImageSpec:
 
     def __post_init__(self):
         self.name = self.name.lower()
+        self._is_force_push = False  # False by default
         if self.registry:
             self.registry = self.registry.lower()
 
@@ -181,6 +183,16 @@ def with_apt_packages(self, apt_packages: Union[str, List[str]]) -> "ImageSpec":
 
         return new_image_spec
 
+    def force_push(self) -> "ImageSpec":
+        """
+        Builder that returns a new image spec with force push enabled.
+        """
+        new_image_spec = copy.deepcopy(self)
+        new_image_spec._is_force_push = True
+        self._is_force_push = True
+
+        return new_image_spec
+
 
 class ImageSpecBuilder:
     @abstractmethod
@@ -222,10 +234,13 @@ def build(cls, image_spec: ImageSpec) -> str:
             builder = image_spec.builder
 
         img_name = image_spec.image_name()
-        if img_name in cls._BUILT_IMAGES or image_spec.exist():
+        if (img_name in cls._BUILT_IMAGES or image_spec.exist()) and not image_spec._is_force_push:
             click.secho(f"Image {img_name} found. Skip building.", fg="blue")
         else:
-            click.secho(f"Image {img_name} not found. Building...", fg="blue")
+            if image_spec._is_force_push:
+                click.secho(f"Image {img_name} found. but overwriting existing image.", fg="blue")
+            else:
+                click.secho(f"Image {img_name} not found. Building...", fg="blue")
             if builder not in cls._REGISTRY:
                 raise Exception(f"Builder {builder} is not registered.")
             if builder == "envd":

tests/flytekit/unit/core/image_spec/test_image_spec.py

@@ -26,10 +26,12 @@ def test_image_spec(mock_image_spec_builder):
         requirements=REQUIREMENT_FILE,
         registry_config=REGISTRY_CONFIG_FILE,
     )
+    assert image_spec._is_force_push is False
 
     image_spec = image_spec.with_commands("echo hello")
     image_spec = image_spec.with_packages("numpy")
     image_spec = image_spec.with_apt_packages("wget")
+    image_spec = image_spec.force_push()
 
     assert image_spec.python_version == "3.8"
     assert image_spec.base_image == "cr.flyte.org/flyteorg/flytekit:py3.8-latest"
@@ -47,6 +49,7 @@ def test_image_spec(mock_image_spec_builder):
     assert image_spec.pip_index is None
     assert image_spec.is_container() is True
     assert image_spec.commands == ["echo hello"]
+    assert image_spec._is_force_push is True
 
     tag = calculate_hash_from_image_spec(image_spec)
     assert image_spec.image_name() == f"flytekit:{tag}"