[OOM-CERT-SERVICE] Add handling cmp response when PBM value is missing.
[oom/platform/cert-service.git] / certService / README.md
index 4780a90..b7d4fdd 100644 (file)
@@ -3,18 +3,18 @@
 ### General description
 More information about the project and all its functionalities you can find under the wiki page: 
     ```
-    https://wiki.onap.org/display/DW/AAF+Certification+Service
+    https://wiki.onap.org/display/DW/OOM+Certification+Service
     ``` 
 
 ### For developers
-    * AAF Cert Service Api is a Spring Boot application
+    * OOM Cert Service Api is a Spring Boot application
     * Code style
         Use Google code formatter in your IDE.
         For IntelliJ use [https://plugins.jetbrains.com/plugin/8527-google-java-format]
         For other IDEs use []https://github.com/google/google-java-format]
 
 ### Local project configuration
-    * Create directory on your system /etc/onap/aaf/certservice
+    * Create directory on your system /etc/onap/oom/certservice
     * Copy sample configuration test/resources/cmpServers.json to that directory
 
 ### Running Locally
@@ -37,7 +37,7 @@ mvn clean package
 ### Building Docker image manually
 Go to the certService subfolder and execute following statement (1.0.0-SNAPSHOT is related to a current project.version parameter):
 ```
-docker build --build-arg VERSION=1.0.0-SNAPSHOT -t onap/org.onap.aaf.certservice.aaf-certservice-api .
+docker build --build-arg VERSION=1.0.0-SNAPSHOT -t onap/org.onap.oom.certservice.oom-certservice-api .
 ```
     
 ### Install the package into the local repository
@@ -45,33 +45,22 @@ docker build --build-arg VERSION=1.0.0-SNAPSHOT -t onap/org.onap.aaf.certservice
 mvn clean install
 ```     
     
-### Building Docker image and  install the package into the local repository
+### Building Docker image and install the package into local repository
 ```
 mvn clean install -P docker
 ```   
 
 ### Running Docker container local
 ```
-docker run -p 8080:8080 --name aaf-certservice-api --mount type=bind,source=/<absolute_path>/cmpServers.json,target=/etc/onap/aaf/certservice/cmpServers.json onap/org.onap.aaf.certservice.aaf-certservice-api
+docker run -p 8080:8080 --name oom-certservice-api --mount type=bind,source=/<absolute_path>/cmpServers.json,target=/etc/onap/
+oom/certservice/cmpServers.json onap/org.onap.oom.certservice.oom-certservice-api
 ```
 
 ### Running Docker container from nexus
 ```
-docker run -p 8080:8080 --name aaf-certservice-api --mount type=bind,source=/<absolute_path>/cmpServers.json,target=/etc/onap/aaf/certservice/cmpServers.json nexus3.onap.org:10001/onap/org.onap.aaf.certservice.aaf-certservice-api:1.0.0
-```
-
-### Running Docker container from docker-compose with EJBCA
-Docker-compose uses nexus image of certservice.
-```
-docker-compose up
+docker run -p 8080:8080 --name oom-certservice-api --mount type=bind,source=/<absolute_path>/cmpServers.json,target=/etc/onap/oom/certservice/cmpServers.json nexus3.onap.org:10001/onap/org.onap.oom.platform.cert-service.oom-certservice-api:1.0.0
 ```
     
-### Running with Helm
-1. Use environment/server with installed kubernetes and helm.
-2. Copy helm/aaf-cert-service directory to that environment.
-3. Enter that environment 
-4. Run ```helm install ./aaf-cert-service```
-
 ### Health Check
 Browser:
 ```
@@ -84,57 +73,23 @@ curl localhost:8080/actuator/health
 ```   
  Should return {"status":"UP"}
 
-### AAF CertService CSITs
-#### CSIT repository
-```
-https://gerrit.onap.org/r/admin/repos/integration/csit
-```
-
-####How to run tests locally
-1. Checkout CSIT repository
-2. Configure CSIT local environment
-3. Inside CSIT directory execute
-```
-sudo ./run-csit.sh plans/aaf/certservice
-```
-
-####Jenkins build
-https://jenkins.onap.org/view/CSIT/job/aaf-master-csit-certservice/
-
 ### Logs locally
 
 path: 
 ```
-var/log/onap/aaf/certservice/
+var/log/onap/oom/certservice/
 ```    
 ### Logs in Docker container
 ```
-docker exec -it aaf-certservice-api bash
+docker exec -it oom-certservice-api bash
 ```
 
 path:
 ```
-cd /var/log/onap/aaf/certservice
+cd /var/log/onap/oom/certservice
 ```
 You should see:    
-audit.log  error.log  trace.log
-
-### Sonar results
-```     
-https://sonarcloud.io/dashboard?id=onap_aaf-certservice
-```
-    
-### Maven artifacts
-All maven artifacts are deployed under nexus uri:
-```
-https://nexus.onap.org/content/repositories/snapshots/org/onap/aaf/certservice/
-```
-        
-### Docker artifacts
-All docker images are hosted under nexus3 uri:
-```
-https://nexus3.onap.org/repository/docker.snapshot/v2/onap/org.onap.aaf.certservice.aaf-certservice-api/
-```
+audit.log  error.log  debug.log
 
 ### RestAPI
 API is described by Swagger ( OpenAPI 3.0 ) on endpoint /docs 
@@ -143,7 +98,6 @@ API is described by Swagger ( OpenAPI 3.0 ) on endpoint /docs
 http://localchost:8080/docs
 ```
 
-### Sonar results
-```     
-https://sonarcloud.io/dashboard?id=onap_aaf-certservice
-```
+### OpenAPI
+during project building yaml file with openAPI 3.0 documentation is generated in target directory with name api-docs.yaml
+file OpenAPI.yaml located in certService directory must be update be hand if needed