README.md

   1 # Cert service
   2
   3 ### General description
   4
   5 More information about the project and all its functionalities you can find under the wiki page:
   6     ```
   7     https://wiki.onap.org/display/DW/AAF+Certification+Service
   8     ```
   9
  10 Project consists of two submodules:
  11 1. aaf-certservice-api
  12 2. aaf-certservice-client
  13
  14 Detailed information about submodules can be found in ```README.md``` in their directories.
  15
  16 ### Project building
  17 ```
  18 mvn clean package
  19 ```
  20
  21 ### Install the packages into the local repository
  22 ```
  23 mvn clean install
  24 ```
  25
  26 ### Building Docker images and install packages into local repository
  27 ```
  28 mvn clean install -P docker
  29 or
  30 make build
  31 ```
  32
  33 ### Generating certificates
  34 There are example certificates already generated in certs/ directory.
  35 In order to generate new certificates, first remove existing ones.
  36 Then execute following command from certs(!) directory:
  37 ```
  38  make
  39 ```
  40
  41 ### Running Docker containers from docker-compose with EJBCA
  42 Docker-compose uses a local image of certservice-api and make run-client uses a local image of certservice-client
  43 Build docker images locally before running docker compose command.
  44 ```
  45 1. Build local images
  46 make build
  47 2. Start Cert Service with configured EJBCA
  48 make start-backend
  49 3. Run Cert Service Client
  50 make run-client
  51 3. Remove client container
  52 make stop-client
  53 4. Stop Cert Service and EJBCA
  54 make stop-backend
  55 ```
  56
  57 ### AAF CertService CSITs
  58 #### CSIT repository
  59 ```
  60 https://gerrit.onap.org/r/admin/repos/integration/csit
  61 ```
  62
  63 ####How to run tests locally
  64 1. Checkout CSIT repository
  65 2. Configure CSIT local environment
  66 3. Inside CSIT directory execute
  67 ```
  68 sudo ./run-csit.sh plans/aaf/certservice
  69 ```
  70
  71 ####Jenkins build
  72 https://jenkins.onap.org/view/CSIT/job/aaf-master-csit-certservice/
  73
  74 ### Sonar results
  75 ```
  76 https://sonarcloud.io/dashboard?id=onap_aaf-certservice
  77 ```
  78
  79 ### Maven artifacts
  80 All maven artifacts are deployed under nexus uri:
  81 ```
  82 https://nexus.onap.org/content/repositories/snapshots/org/onap/aaf/certservice/
  83 ```
  84
  85 ### Docker artifacts
  86 All docker images are hosted under nexus3 uri:
  87 ```
  88 https://nexus3.onap.org/repository/docker.snapshot/v2/onap/org.onap.aaf.certservice.aaf-certservice-api/
  89 ```