dashboard/webapp-backend/src/main/java/org/oransc/ric/portal/dashboard/controller/CaasIngressController.java

   1 /*-
   2  * ========================LICENSE_START=================================
   3  * O-RAN-SC
   4  * %%
   5  * Copyright (C) 2019 AT&T Intellectual Property
   6  * %%
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  *      http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  * ========================LICENSE_END===================================
  19  */
  20 package org.oransc.ric.portal.dashboard.controller;
  21
  22 import java.lang.invoke.MethodHandles;
  23
  24 import org.oransc.ric.portal.dashboard.DashboardConstants;
  25 import org.oransc.ric.portal.dashboard.config.SimpleKubernetesClientBuilder;
  26 import org.oransc.ric.portal.dashboard.k8sapi.SimpleKubernetesClient;
  27 import org.slf4j.Logger;
  28 import org.slf4j.LoggerFactory;
  29 import org.springframework.beans.factory.annotation.Autowired;
  30 import org.springframework.context.annotation.Configuration;
  31 import org.springframework.http.MediaType;
  32 import org.springframework.http.ResponseEntity;
  33 import org.springframework.security.access.annotation.Secured;
  34 import org.springframework.util.Assert;
  35 import org.springframework.web.bind.annotation.GetMapping;
  36 import org.springframework.web.bind.annotation.PathVariable;
  37 import org.springframework.web.bind.annotation.RequestMapping;
  38 import org.springframework.web.bind.annotation.RestController;
  39
  40 import io.swagger.annotations.ApiOperation;
  41
  42 /**
  43  * Proxies calls from the front end to a CAAS-Ingress API, which is a proxy for
  44  * a Kubernetes API.
  45  *
  46  * If a method throws RestClientResponseException, it is handled by
  47  * {@link CustomResponseEntityExceptionHandler#handleProxyMethodException(Exception, org.springframework.web.context.request.WebRequest)}
  48  * which returns status 502. All other exceptions are handled by Spring which
  49  * returns status 500.
  50  */
  51 @Configuration
  52 @RestController
  53 @RequestMapping(value = CaasIngressController.CONTROLLER_PATH, produces = MediaType.APPLICATION_JSON_VALUE)
  54 public class CaasIngressController {
  55
  56         private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());
  57
  58         // Publish constants so tests are easy to write
  59         public static final String CONTROLLER_PATH = DashboardConstants.ENDPOINT_PREFIX + "/caas-ingress";
  60         // Endpoints
  61         public static final String PODS_METHOD = "pods";
  62         // Path parameters
  63         public static final String PP_CLUSTER = "cluster";
  64         public static final String PP_NAMESPACE = "namespace";
  65         // Parameter values
  66         public static final String CLUSTER_PLT = "plt";
  67         public static final String CLUSTER_RIC = "ric"; // alternate for PLT
  68
  69         // Populated by the autowired constructor
  70         private final SimpleKubernetesClientBuilder simpleKubernetesClientBuilder;
  71
  72         @Autowired
  73         public CaasIngressController(final SimpleKubernetesClientBuilder simpleKubernetesClientBuilder) {
  74                 Assert.notNull(simpleKubernetesClientBuilder, "builder must not be null");
  75                 this.simpleKubernetesClientBuilder = simpleKubernetesClientBuilder;
  76                 if (logger.isDebugEnabled())
  77                         logger.debug("ctor: configured with builder type {}", simpleKubernetesClientBuilder.getClass().getName());
  78         }
  79
  80         /*
  81          * No need to parse the V1PodList, just pass thru as a string.
  82          */
  83         @ApiOperation(value = "Gets list of pods in the specified cluster for the specified namespace", response = String.class)
  84         @GetMapping(DashboardConstants.RIC_INSTANCE_KEY + "/{" + DashboardConstants.RIC_INSTANCE_KEY + "}/" + PODS_METHOD
  85                         + "/" + PP_CLUSTER + "/{" + PP_CLUSTER + "}" + "/" + PP_NAMESPACE + "/{" + PP_NAMESPACE + "}")
  86         @Secured({ DashboardConstants.ROLE_ADMIN, DashboardConstants.ROLE_STANDARD })
  87         public ResponseEntity<String> listPods(@PathVariable(DashboardConstants.RIC_INSTANCE_KEY) String instanceKey, //
  88                         @PathVariable(PP_CLUSTER) String cluster, //
  89                         @PathVariable(PP_NAMESPACE) String namespace) {
  90                 logger.debug("listPods: instance {} cluster {} namespace {}", instanceKey, cluster, namespace);
  91                 SimpleKubernetesClient client = simpleKubernetesClientBuilder.getSimpleKubernetesClient(instanceKey);
  92                 if (CLUSTER_PLT.equalsIgnoreCase(cluster) || CLUSTER_RIC.equalsIgnoreCase(cluster)) {
  93                         return ResponseEntity.ok().body(client.listPods(namespace));
  94                 } else {
  95                         final String msg = "listPods: unknown cluster " + cluster;
  96                         logger.warn(msg);
  97                         return ResponseEntity.badRequest().body(msg);
  98                 }
  99         }
 100
 101 }