X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=certService%2FREADME.md;h=1b24747a2f0b43fb8a18a9e91dc2276767664469;hb=b8c4e6867d6b26652f4382e93665c220769cdc9f;hp=4780a904269720800446b13f5edc7ce76bbf4aed;hpb=be552bb854e00ad79d0854304226829d0f969fb6;p=oom%2Fplatform%2Fcert-service.git diff --git a/certService/README.md b/certService/README.md index 4780a904..1b24747a 100644 --- a/certService/README.md +++ b/certService/README.md @@ -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=//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=//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=//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=//cmpServers.json,target=/etc/onap/oom/certservice/cmpServers.json nexus3.onap.org:10001/onap/org.onap.oom.certservice.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