NOTES

   1  -------------------------------------------------------------------------------
   2     Copyright (c) 2018-2019 AT&T Intellectual Property.
   3
   4    Licensed under the Apache License, Version 2.0 (the "License");
   5    you may not use this file except in compliance with the License.
   6    You may obtain a copy of the License at
   7
   8        http://www.apache.org/licenses/LICENSE-2.0
   9
  10    Unless required by applicable law or agreed to in writing, software
  11    distributed under the License is distributed on an "AS IS" BASIS,
  12    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13    See the License for the specific language governing permissions and
  14    limitations under the License.
  15  -------------------------------------------------------------------------------
  16
  17 Miscellaneous Notes about the repository, organisation etc.
  18
  19
  20 Continuous Integration
  21
  22 The CI process is managed via several Jenkins jobs which are triggered
  23 at various times during the commit, review and merge process. These
  24 jobs are managed in the gerrit.o-ran-sc.org ci_management repo. Specifically,
  25 the information in the jjb/ric-app-mc are of interest to this project.
  26 At a high level, each image that is created from this repo has a "project"
  27 description in the .yaml file which defines several key items about how
  28 and when the job(s) are executed.
  29
  30 Currently the CI process is applied to the mc-core and sidecars/listener
  31 directorys. A docker image is built for each, and is only built when there
  32 are changes to the respective subdirectory. Images are built using the
  33 Dockerfile at the top level of each subdirectory, e.g. mc-core/Dockerfile.
  34 The image version, or tag, is applied by reading the container-tag.yaml
  35 file in the same directory as the Dockerfile.
  36
  37 There is a specific "template" for each project which actually defines
  38 the Jenkins jobs.  At the moment these are black box things and maintained
  39 by the CI group. In order to add another "project," (i.e. generate another
  40 image), a related set of these templates must be created before the .yaml
  41 file in the CI repo can be modified.
  42
  43 The basic steps to add a new project:
  44   - Create the subdirectory and add a docker and tag file
  45   - Contact the CI maintainers to add the templates
  46   - Modify the MC .yaml file in the ci-management repo to add the project