Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Code Block
languageyaml
...
gitAuthentication:
  sshKey: "/opt/dm/mci/workbench.key"       # Location of our private SSH key
  httpsEnabled: true                        # Set true to use HTTPS
  httpsProvider: "SunJSSE"                  #
  httpsCredentialsStore:                    # Details of the SSL certificate file
    type: "PKCS12"
    path: "/opt/dm/mci/.secrets/git-credentials.p12"
    password: "${file:UTF-8:/opt/dm/mci/.secrets/git-credentials-keystore-password}"
...
Note

The comments in the example above are just for clarity. You should not have any comments or trailing whitespace after the entries in your config.yml.

...

Info

If you are upgrading from an older version of Workbench, you will need to create this file yourself using the following instructions:-

  1. Make sure the MettleCI Workbench Service is stopped

    Code Block
    $> service dm-mettleci-workbench stop
  2. Edit the config.yml file and add or set the httpsEnabled entry under the sshKey entry. Make sure it is set to false for the time being.

    Code Block
    gitAuthentication:
      sshKey: "/opt/dm/mci/workbench.key"
      httpsEnabled: false
  3. In order to create the password file make sure to login as the mciworkb user.

    Code Block
    $> sudo su - mciworkb
    $> cd /opt/dm/mci
    $> umask 006
    $> touch .secrets/git-credentials-keystore-password
  4. Edit the file with your preferred editor and enter a new password

    Code Block
    $> vim .secrets/git-credentials-keystore-password
    
    any_random_generated_password_with_letters_numbers_and_symbols
    
  5. Edit the config.yml file and add or set the httpsEnabled entry to true under the sshKey entry.

    Code Block
    gitAuthentication:
      sshKey: "/opt/dm/mci/workbench.key"
      httpsEnabled: true
  6. MettleCI Workbench will need to be restarted after saving changes to config.yml.

    Code Block
    $> service dm-mettleci-workbench start
  7. Check that the keystore has been created by MettleCI Workbench

    Code Block
    $> ls -l /opt/dm/mci/.secrets/git-credentials*
    -rw-rw---- 1 mciworkb dstage  18 Jun  9 20:58 /opt/dm/mci/.secrets/git-credentials-keystore-password
    -rw-rw---- 1 mciworkb dstage 297 Jun  9 21:17 /opt/dm/mci/.secrets/git-credentials.p12

User Profile Git Configuration

...