Release2/allow-cloudinit-configuration.md

   1 # Allow cloudinit configuration #
   2
   3 ## Proposer ##
   4 **EUAG**
   5
   6 ## Type ##
   7 **Feature**
   8
   9 ## Target MDG/TF ##
  10 UI, RO, SO
  11
  12 ## Description ##
  13 Currently, OSM cannot leverage on the traditional metadata "cloud-init" procedures, commonly used
  14 in cloud environments. "cloud-init" is typically used for the initial configuration of virtual
  15 machines where the user can inject context information (configuration parameters and scripts) to
  16 grant the initial VM setup.
  17
  18 This configuration can be independent of the initial SO configuration.
  19
  20 The specific configuration can be defined at 3 levels:
  21
  22 1. A VNFD can contain cloud-init metadata (configuration parameters and scripts) for each VM.
  23 2. An NSD can override this metadata for each one of its VNFs.
  24 3. Finally, the end user can override this metadata at instantiation time.
  25
  26 In order to have this feature implemented, the following changes are devised:
  27
  28 - In the UI:
  29     - The end user can see/edit the metadata information for every virtual machine at instantiation
  30     time
  31 - In the RO:
  32     - Database changes to annotate instance-related information.
  33     - Changes in northbound API to allow that information.
  34     - Changes in VIM connector to transmit this information.
  35 - In the SO:
  36     - VNFD and NSD data models should incorporate this information
  37     - Connection to RO must be modified accordingly to the changes in RO northbound API.
  38     - Database changes to annotate this information.
  39
  40
  41 ## Demo or definition of done ##
  42 The test consists in the deployment of an NS instance, where user-defined scripts have been
  43 injected as cloud-init metadata. The user-defined scripts can be injected at different levels: VNFD
  44 level, NSD level and NS instance level. The test should do as many deployments as level
  45 combinations are possible.
  46
  47 The test is considered successful if the appropriate script is executed (it could be a simple
  48 "touch file").