improved create service error message

pkg/errors/errors.go

@@ -0,0 +1,14 @@
+package errors
+
+import (
+	"fmt"
+	"strings"
+)
+
+func newInvalidCRD(apiGroup string) *KNError {
+	parts := strings.Split(apiGroup, ".")
+	name := parts[0]
+	msg := fmt.Sprintf("no Knative %s API found on the backend. Please verify the installation.", name)
+
+	return NewKNError(msg)
+}

pkg/errors/errors_test.go

@@ -0,0 +1,18 @@
+package errors
+
+import (
+	"gotest.tools/assert"
+	"testing"
+)
+
+func TestNewInvalidCRD(t *testing.T) {
+	err := newInvalidCRD("serving.knative.dev")
+	assert.Error(t, err, "no Knative serving API found on the backend. Please verify the installation.")
+
+	err = newInvalidCRD("serving")
+	assert.Error(t, err, "no Knative serving API found on the backend. Please verify the installation.")
+
+	err = newInvalidCRD("")
+	assert.Error(t, err, "no Knative  API found on the backend. Please verify the installation.")
+
+}

pkg/errors/factory.go

@@ -0,0 +1,34 @@
+package errors
+
+import (
+	api_errors "k8s.io/apimachinery/pkg/api/errors"
+	"k8s.io/apimachinery/pkg/apis/meta/v1"
+	"strings"
+)
+
+func isCRDError(status api_errors.APIStatus) bool {
+	for _, cause := range status.Status().Details.Causes {
+		if strings.HasPrefix(cause.Message, "404")  && cause.Type == v1.CauseTypeUnexpectedServerResponse {
+			return true
+		}
+	}
+
+	return false
+}
+
+func Build(err error) error {
+	apiStatus, ok := err.(api_errors.APIStatus)
+	if !ok {
+		return err
+	}
+
+	var knerr *KNError
+
+	if isCRDError(apiStatus) {
+		knerr = newInvalidCRD(apiStatus.Status().Details.Group)
+		knerr.Status = apiStatus
+		return knerr
+	}
+
+	return err
+}

pkg/errors/factory_test.go

@@ -0,0 +1,43 @@
+package errors
+
+import (
+	"github.com/pkg/errors"
+	"gotest.tools/assert"
+	api_errors "k8s.io/apimachinery/pkg/api/errors"
+	"k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/runtime/schema"
+	"testing"
+)
+
+func TestBuild(t *testing.T) {
+	//default non api error
+	defaultError := errors.New("my-custom-error")
+	err := Build(defaultError)
+	assert.Error(t, err, "my-custom-error")
+
+	gv := schema.GroupResource{
+		Group: "serving.knative.dev",
+		Resource: "service",
+	}
+
+	//api error containing expected error when knative crd is not available
+	apiError := api_errors.NewNotFound(gv, "serv")
+	apiError.Status().Details.Causes = []v1.StatusCause{
+		{
+			Type: "UnexpectedServerResponse",
+			Message: "404 page not found",
+		},
+	}
+	err = Build(apiError)
+	assert.Error(t, err, "no Knative serving API found on the backend. Please verify the installation.")
+
+	//api error not registered in error factory
+	apiError = api_errors.NewAlreadyExists(gv, "serv")
+	err = Build(apiError)
+	assert.Error(t, err, "service.serving.knative.dev \"serv\" already exists")
+
+	//default not found api error
+	apiError = api_errors.NewNotFound(gv, "serv")
+	err = Build(apiError)
+	assert.Error(t, err, "service.serving.knative.dev \"serv\" not found")
+}

pkg/errors/knerror.go

@@ -0,0 +1,11 @@
+package errors
+
+func NewKNError(msg string) *KNError {
+	return &KNError{
+		msg: msg,
+	}
+}
+
+func (kne *KNError) Error() string {
+	return kne.msg
+}

pkg/errors/knerror_test.go

@@ -0,0 +1,22 @@
+package errors
+
+import (
+	"gotest.tools/assert"
+	"testing"
+)
+
+func TestNewKNError(t *testing.T) {
+	err := NewKNError("myerror")
+	assert.Error(t, err, "myerror")
+
+	err = NewKNError("")
+	assert.Error(t, err, "")
+}
+
+func TestKNError_Error(t *testing.T) {
+	err := NewKNError("myerror")
+	assert.Equal(t, err.Error(), "myerror")
+
+	err = NewKNError("")
+	assert.Equal(t, err.Error(), "")
+}

pkg/errors/types.go

@@ -0,0 +1,8 @@
+package errors
+
+import api_errors "k8s.io/apimachinery/pkg/api/errors"
+
+type KNError struct {
+	Status api_errors.APIStatus
+	msg string
+}

pkg/serving/v1alpha1/client.go

@@ -24,10 +24,11 @@ import (
 	"github.com/knative/client/pkg/serving"
 	"github.com/knative/client/pkg/wait"
 
+	kn_errors "github.com/knative/client/pkg/errors"
 	api_serving "github.com/knative/serving/pkg/apis/serving"
 	"github.com/knative/serving/pkg/apis/serving/v1alpha1"
 	client_v1alpha1 "github.com/knative/serving/pkg/client/clientset/versioned/typed/serving/v1alpha1"
-	v1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+	"k8s.io/apimachinery/pkg/apis/meta/v1"
 	"k8s.io/apimachinery/pkg/labels"
 	"k8s.io/apimachinery/pkg/runtime"
 )
@@ -130,7 +131,7 @@ func NewKnServingClient(client client_v1alpha1.ServingV1alpha1Interface, namespa
 func (cl *knClient) GetService(name string) (*v1alpha1.Service, error) {
 	service, err := cl.client.Services(cl.namespace).Get(name, v1.GetOptions{})
 	if err != nil {
-		return nil, err
+		return nil, kn_errors.Build(err)
 	}
 	err = serving.UpdateGroupVersionKind(service, v1alpha1.SchemeGroupVersion)
 	if err != nil {
@@ -143,7 +144,7 @@ func (cl *knClient) GetService(name string) (*v1alpha1.Service, error) {
 func (cl *knClient) ListServices(config ...ListConfig) (*v1alpha1.ServiceList, error) {
 	serviceList, err := cl.client.Services(cl.namespace).List(ListConfigs(config).toListOptions())
 	if err != nil {
-		return nil, err
+		return nil, kn_errors.Build(err)
 	}
 	serviceListNew := serviceList.DeepCopy()
 	err = updateServingGvk(serviceListNew)
@@ -167,7 +168,7 @@ func (cl *knClient) ListServices(config ...ListConfig) (*v1alpha1.ServiceList, e
 func (cl *knClient) CreateService(service *v1alpha1.Service) error {
 	_, err := cl.client.Services(cl.namespace).Create(service)
 	if err != nil {
-		return err
+		return kn_errors.Build(err)
 	}
 	return updateServingGvk(service)
 }
@@ -183,10 +184,15 @@ func (cl *knClient) UpdateService(service *v1alpha1.Service) error {
 
 // Delete a service by name
 func (cl *knClient) DeleteService(serviceName string) error {
-	return cl.client.Services(cl.namespace).Delete(
+	err := cl.client.Services(cl.namespace).Delete(
 		serviceName,
 		&v1.DeleteOptions{},
 	)
+	if err != nil {
+		return kn_errors.Build(err)
+	}
+
+	return nil
 }
 
 // Wait for a service to become ready, but not longer than provided timeout
@@ -199,7 +205,7 @@ func (cl *knClient) WaitForService(name string, timeout time.Duration) error {
 func (cl *knClient) GetRevision(name string) (*v1alpha1.Revision, error) {
 	revision, err := cl.client.Revisions(cl.namespace).Get(name, v1.GetOptions{})
 	if err != nil {
-		return nil, err
+		return nil, kn_errors.Build(err)
 	}
 	err = updateServingGvk(revision)
 	if err != nil {
@@ -210,14 +216,19 @@ func (cl *knClient) GetRevision(name string) (*v1alpha1.Revision, error) {
 
 // Delete a revision by name
 func (cl *knClient) DeleteRevision(name string) error {
-	return cl.client.Revisions(cl.namespace).Delete(name, &v1.DeleteOptions{})
+	err := cl.client.Revisions(cl.namespace).Delete(name, &v1.DeleteOptions{})
+	if err != nil {
+		return kn_errors.Build(err)
+	}
+
+	return nil
 }
 
 // List revisions
 func (cl *knClient) ListRevisions(config ...ListConfig) (*v1alpha1.RevisionList, error) {
 	revisionList, err := cl.client.Revisions(cl.namespace).List(ListConfigs(config).toListOptions())
 	if err != nil {
-		return nil, err
+		return nil, kn_errors.Build(err)
 	}
 	return updateServingGvkForRevisionList(revisionList)
 }
@@ -308,3 +319,4 @@ func serviceConditionExtractor(obj runtime.Object) (apis.Conditions, error) {
 	}
 	return apis.Conditions(service.Status.Conditions), nil
 }
+