From 376502396f2f518218f404cb74ebdbd7247804c4 Mon Sep 17 00:00:00 2001
From: Clive Cox <cc@seldon.io>
Date: Thu, 4 Apr 2019 10:30:00 +0100
Subject: [PATCH 1/4] Add tests for parameters

---
 .gitignore                         |   1 +
 python/.coverage                   | Bin 98304 -> 0 bytes
 python/seldon_core/microservice.py |  16 +++++++++++++++-
 python/tests/test_microservice.py  |  18 ++++++++++++++++++
 4 files changed, 34 insertions(+), 1 deletion(-)
 delete mode 100644 python/.coverage

diff --git a/.gitignore b/.gitignore
index 8deb9719d1..4fe6a7a536 100644
--- a/.gitignore
+++ b/.gitignore
@@ -189,3 +189,4 @@ doc/source/_static/cluster-manager
 python/build/
 python/dist/
 testing/scripts/proto
+python/.coverage
\ No newline at end of file
diff --git a/python/.coverage b/python/.coverage
deleted file mode 100644
index 55b0da67e9157f1f0b706ebcc498deeb7cb2e3d5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 98304
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

diff --git a/python/seldon_core/microservice.py b/python/seldon_core/microservice.py
index c6577e07ee..28d82e57cc 100644
--- a/python/seldon_core/microservice.py
+++ b/python/seldon_core/microservice.py
@@ -11,6 +11,7 @@
 from seldon_core.flask_utils import ANNOTATIONS_FILE
 import seldon_core.wrapper as seldon_microservice
 from typing import Dict, Callable
+from seldon_core.flask_utils import SeldonMicroserviceException
 
 logger = logging.getLogger(__name__)
 
@@ -70,7 +71,16 @@ def parse_parameters(parameters: Dict) -> Dict:
         if type_ == "BOOL":
             parsed_parameters[name] = bool(strtobool(value))
         else:
-            parsed_parameters[name] = type_dict[type_](value)
+            try:
+                parsed_parameters[name] = type_dict[type_](value)
+            except ValueError:
+                raise SeldonMicroserviceException(
+                    "Bad model parameter: " + name + " with value " + value + " can't be parsed as a " + type_,
+                    reason="MICROSERVICE_BAD_PARAMETER")
+            except KeyError:
+                raise SeldonMicroserviceException(
+                    "Bad model parameter type: " + type_ + " valid are INT, FLOAT, DOUBLE, STRING, BOOL",
+                    reason="MICROSERVICE_BAD_PARAMETER")
     return parsed_parameters
 
 
@@ -167,6 +177,7 @@ def main():
     log_level_num = getattr(logging, args.log_level.upper(), None)
     if not isinstance(log_level_num, int):
         raise ValueError('Invalid log level: %s', args.log_level)
+
     logger.setLevel(log_level_num)
     logger.debug("Log level set to %s:%s", args.log_level, log_level_num)
 
@@ -185,6 +196,9 @@ def main():
 
     # set log level for the imported microservice type
     seldon_microservice.logger.setLevel(log_level_num)
+    logging.getLogger().setLevel(log_level_num)
+    for handler in logger.handlers:
+        handler.setLevel(log_level_num)
 
     port = int(os.environ.get(SERVICE_PORT_ENV_NAME, DEFAULT_PORT))
 
diff --git a/python/tests/test_microservice.py b/python/tests/test_microservice.py
index 4a2d60cbdb..14f016305a 100644
--- a/python/tests/test_microservice.py
+++ b/python/tests/test_microservice.py
@@ -8,9 +8,12 @@
 import pytest
 from seldon_core.proto import prediction_pb2
 from seldon_core.proto import prediction_pb2_grpc
+import seldon_core.microservice as microservice
+from seldon_core.flask_utils import SeldonMicroserviceException
 import grpc
 import numpy as np
 import signal
+import unittest
 
 @contextmanager
 def start_microservice(app_location,tracing=False,grpc=False,envs={}):
@@ -116,6 +119,7 @@ def test_model_template_app_grpc(tracing):
         feedback = prediction_pb2.Feedback(request=request,reward=1.0)
         response = stub.SendFeedback(request=request)
 
+
 def test_model_template_app_tracing_config():
     envs = {"JAEGER_CONFIG_PATH":join(dirname(__file__), "tracing_config/tracing.yaml")}
     with start_microservice(join(dirname(__file__), "model-template-app"),tracing=True,envs=envs):
@@ -133,3 +137,17 @@ def test_model_template_app_tracing_config():
             "http://127.0.0.1:5000/send-feedback", params="json=%s" % data)
         response.raise_for_status()
         assert response.json() == {'data': {'ndarray': []}, 'meta': {}}
+
+
+def test_model_template_bad_params():
+
+    params = [join(dirname(__file__), "model-template-app"),"seldon-core-microservice","REST","--parameters",'[{"type":"FLOAT","name":"foo","value":"abc"}]']
+    with unittest.mock.patch('sys.argv',params):
+        with pytest.raises(SeldonMicroserviceException):
+            microservice.main()
+
+def test_model_template_bad_params_type():
+    params = [join(dirname(__file__), "model-template-app"),"seldon-core-microservice","REST","--parameters",'[{"type":"FOO","name":"foo","value":"abc"}]']
+    with unittest.mock.patch('sys.argv',params):
+        with pytest.raises(SeldonMicroserviceException):
+            microservice.main()
\ No newline at end of file

From 7784e85db2d9f7b0295eadf6dd8109bded3b0b70 Mon Sep 17 00:00:00 2001
From: Clive Cox <cc@seldon.io>
Date: Thu, 4 Apr 2019 15:40:43 +0100
Subject: [PATCH 2/4] Fix status update on failed deployments

---
 .../k8s/SeldonDeploymentStatusUpdateImpl.java |  2 +-
 .../k8s/SeldonDeploymentStatusUpdateTest.java | 29 ++++++++-
 .../src/test/resources/model_failed.json      | 61 +++++++++++++++++++
 3 files changed, 90 insertions(+), 2 deletions(-)
 create mode 100644 cluster-manager/src/test/resources/model_failed.json

diff --git a/cluster-manager/src/main/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateImpl.java b/cluster-manager/src/main/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateImpl.java
index fe8f1df7a5..192cad27a0 100644
--- a/cluster-manager/src/main/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateImpl.java
+++ b/cluster-manager/src/main/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateImpl.java
@@ -105,7 +105,7 @@ public void updateStatus(String mlDepName, String version, String depName, Integ
         {
             logger.info(String.format("UPDATE %s : %s %d %d",mlDepName,depName,replicas,replicasAvailable));
             SeldonDeployment mlDep = crdHandler.getSeldonDeployment(mlDepName,version, namespace);
-            if (mlDep != null)
+            if (mlDep != null && !(mlDep.getStatus().hasState() && mlDep.getStatus().getState().equals(Constants.STATE_FAILED)))
             {
                 SeldonDeployment.Builder mlBuilder = SeldonDeployment.newBuilder(mlDep);
                 
diff --git a/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java b/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
index f4e70e6372..cc4b551826 100644
--- a/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
+++ b/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
@@ -6,6 +6,7 @@
 import static org.mockito.Mockito.times;
 import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
+import static org.mockito.Mockito.never;
 
 import java.io.IOException;
 import java.nio.charset.StandardCharsets;
@@ -53,9 +54,32 @@ public void updateAvailableTest() throws IOException
 		
 		supdate.updateStatus(selDepName, version, "test-deployment-fx-market-predictor-8e1d76f", 1, 1, namespace);
 		
+		verify(mockCrdHandler,times(1)).getSeldonDeployment(eq(selDepName), eq(version), eq(namespace));
+		verify(mockCrdHandler,times(1)).updateSeldonDeploymentStatus(any(SeldonDeployment.class));
+
+	}
+	
+	@Test
+	public void updateAvailableOnFailedTest() throws IOException
+	{
+		createMocks();
+		
+		String jsonStr = readFile("src/test/resources/model_failed.json",StandardCharsets.UTF_8);
+        SeldonDeployment sDep = SeldonDeploymentUtils.jsonToSeldonDeployment(jsonStr);
+		
+		when(mockCrdHandler.getSeldonDeployment(any(String.class), any(String.class), any(String.class))).thenReturn(sDep);
+		
+		SeldonDeploymentStatusUpdate supdate = new SeldonDeploymentStatusUpdateImpl(mockCrdHandler, mockSeldonDeploymentController, props);
+		
+		final String selDepName = "SeldonDep1";
+		final String version = "v1alpha1";
+		final String namespace = "seldon";
+		
+		supdate.updateStatus(selDepName, version, "test-deployment-fx-market-predictor-8e1d76f", 1, 1, namespace);
+		
 		verify(mockCrdHandler,times(1)).getSeldonDeployment(eq(selDepName), eq(version), eq(namespace));
 		ArgumentCaptor<SeldonDeployment> argument = ArgumentCaptor.forClass(SeldonDeployment.class);
-		verify(mockCrdHandler,times(1)).updateSeldonDeploymentStatus(argument.capture());
+		verify(mockCrdHandler,never()).updateSeldonDeploymentStatus(argument.capture());
 		
 		SeldonDeployment sDepUpdated = argument.getAllValues().get(0);
 		Assert.assertEquals(1, sDepUpdated.getStatus().getPredictorStatusCount());
@@ -63,6 +87,7 @@ public void updateAvailableTest() throws IOException
 		Assert.assertEquals("Available", sDepUpdated.getStatus().getState());
 	}
 	
+	
 	@Test
 	public void twoUpdatesTest() throws IOException
 	{
@@ -126,5 +151,7 @@ public void removeTest() throws IOException
 		Assert.assertEquals("", sDepUpdated.getStatus().getState());
 	}
 	
+	
+	
 
 }
diff --git a/cluster-manager/src/test/resources/model_failed.json b/cluster-manager/src/test/resources/model_failed.json
new file mode 100644
index 0000000000..0c0ed309ac
--- /dev/null
+++ b/cluster-manager/src/test/resources/model_failed.json
@@ -0,0 +1,61 @@
+{
+    "apiVersion": "machinelearning.seldon.io/v1alpha3",
+    "kind": "SeldonDeployment",
+    "metadata": {
+        "creationTimestamp": "2019-04-04T14:33:08Z",
+        "generation": 1,
+        "labels": {
+            "app": "seldon"
+        },
+        "name": "seldon-model",
+        "namespace": "seldon",
+        "resourceVersion": "6700",
+        "selfLink": "/apis/machinelearning.seldon.io/v1alpha3/namespaces/seldon/seldondeployments/seldon-model",
+        "uid": "9101adcf-56e6-11e9-865f-ec5f8735c09f"
+    },
+    "spec": {
+        "name": "test-deployment",
+        "oauth_key": "oauth-key",
+        "oauth_secret": "oauth-secret",
+        "predictors": [
+            {
+                "componentSpecs": [
+                    {
+                        "spec": {
+                            "containers": [
+                                {
+                                    "imagePullPolicy": "IfNotPresent",
+                                    "image": "seldonio/mock_classifier:1.0",
+                                    "name": "classifier",
+                                    "resources": {
+                                        "requests": {
+                                            "memory": "1Mi"
+                                        }
+                                    }
+                                }
+                            ],
+                            "terminationGracePeriodSeconds": 1
+                        }
+                    }
+                ],
+                "graph": {
+                    "children": [],
+                    "endpoint": {
+                        "type": "REST"
+                    },
+                    "name": "classifier",
+                    "type": "MODEL"
+                },
+                "labels": {
+                    "version": "v1"
+                },
+                "name": "example",
+                "replicas": 1
+            }
+        ]
+    },
+    "status": {
+        "description": "Cannot find field: imagename in message k8s.io.api.core.v1.Container",
+        "state": "Failed"
+    }
+}

From 55e48496f3b710a3550f955591f699aece266258 Mon Sep 17 00:00:00 2001
From: Clive Cox <cc@seldon.io>
Date: Thu, 4 Apr 2019 15:49:48 +0100
Subject: [PATCH 3/4] fixes bad principal in apife #454

---
 .../java/io/seldon/apife/deployments/DeploymentStore.java    | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/api-frontend/src/main/java/io/seldon/apife/deployments/DeploymentStore.java b/api-frontend/src/main/java/io/seldon/apife/deployments/DeploymentStore.java
index c0da1f76d1..f0e37ae96f 100644
--- a/api-frontend/src/main/java/io/seldon/apife/deployments/DeploymentStore.java
+++ b/api-frontend/src/main/java/io/seldon/apife/deployments/DeploymentStore.java
@@ -60,7 +60,10 @@ private void init() throws Exception{
 	 
 	public SeldonDeployment getDeployment(String clientId)
 	{
-		return deploymentStore.get(clientId);
+		if (clientId != null)
+			return deploymentStore.get(clientId);
+		else
+			return null;
 	}
 	  
 	 @Override

From 0df7c981a39d8daf2240556bb448653911bac7fe Mon Sep 17 00:00:00 2001
From: Clive Cox <cc@seldon.io>
Date: Thu, 4 Apr 2019 16:06:40 +0100
Subject: [PATCH 4/4] fic status update tests

---
 .../k8s/SeldonDeploymentStatusUpdateTest.java             | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java b/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
index cc4b551826..d9d81eb218 100644
--- a/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
+++ b/cluster-manager/src/test/java/io/seldon/clustermanager/k8s/SeldonDeploymentStatusUpdateTest.java
@@ -78,13 +78,7 @@ public void updateAvailableOnFailedTest() throws IOException
 		supdate.updateStatus(selDepName, version, "test-deployment-fx-market-predictor-8e1d76f", 1, 1, namespace);
 		
 		verify(mockCrdHandler,times(1)).getSeldonDeployment(eq(selDepName), eq(version), eq(namespace));
-		ArgumentCaptor<SeldonDeployment> argument = ArgumentCaptor.forClass(SeldonDeployment.class);
-		verify(mockCrdHandler,never()).updateSeldonDeploymentStatus(argument.capture());
-		
-		SeldonDeployment sDepUpdated = argument.getAllValues().get(0);
-		Assert.assertEquals(1, sDepUpdated.getStatus().getPredictorStatusCount());
-		Assert.assertEquals(1, sDepUpdated.getStatus().getPredictorStatus(0).getReplicasAvailable());
-		Assert.assertEquals("Available", sDepUpdated.getStatus().getState());
+		verify(mockCrdHandler,never()).updateSeldonDeploymentStatus(any(SeldonDeployment.class));	
 	}