OpenCPN

Prerequisite Cloud Services

Needed for Build and Deployment.

Github --> CircleCI  --> Cloudsmith --> Library
 Code       Build        Deploy to       Catalog

Cloud Services

We assume you have or are able to configure the following free opensource accounts/services:

  1. Code Repository GitHub

  2. Deployment Repository Cloudsmith

  3. Build Tool CircleCI Needs authorizations from Code & Deploy repositories.. Note: Travis-CI.com is no longer free Opensource and therefore is not used.

If you do not have these accounts, register as a free opensource account and save your passwords. Use your github account to register and sign in to Circleci and Cloudsmith if possible.

Authorization Keys

There are two essential authorization keys needed to establish secure workflow communications between your cloud services. It is a good idea to record these and keep them readily available for reference.

Github Personal Authorization Token #1

 Code          Build    Auth-Key
Github  <--  CircleCI (Github Key #1)

Github OpenSource accounts/repositories are Public and readily accessible for download by BUILD services, however

  1. CircleCI does not need a key because your github account was used to register, so the keys can be created and registered from within circleci.

A. Create a Github Personal Authorization Token (Git PAToken)

This has changed. From CircleCI enable the CircleCI "Github App" See other notes here https://github.com/jongough/testplugin_pi/issues/451 for the time being.

  1. In your Github account: github.com[username]

B. Authorize communication with Github

  • CircleCI

This has changed. From CircleCI enable the CircleCI "Github App" See other notes here https://github.com/jongough/testplugin_pi/issues/451 for the time being.

Cloudsmith API Key #2

Deploy to       Build      Auth-Key
Cloudsmith <-- CircleCI (Cloudsmith Key #2)

  1. CircleCI requires your CLOUDSMITH_API_KEY to push build files to Cloudsmith.

  2. Cloudsmith uses a single key for multiple plugins.

A. Get your CLOUDSMITH_API_KEY

  1. Login into your account and use upper right dropdown menu.

  2. Settings > API and copy the API key for later reuse.

  3. Do not hit refesh unless you must replace it.

B. Authorize workflow deployment to Cloudsmith

  • CircleCI

    1. Enter your key into CircleCI as follows:

    2. Projects (or plugin) > Project Settings > Environment Variables

    3. Enter "Name" = CLOUDSMITH_API_KEY and "Variable" = [Enter your number key from Cloudsmith]

Other Useful Settings

CircleCI Settings

Project - Plugin > Settings > Advanced Turn on Github status updates and Build Forked Pull Requests

Setup Cloudsmith Repositories next

Cloudsmith Repository Setup

Note

If some part of the workflow does not seem to be working during first setup of these services, it is probably associated with these keys or your service dashboard settings.

*