Riverice

RiverIce - Getting Started

RiverIce is a tool developed in house written to enable autonomy in Github while also keeping our organization secure. RiverIce was generated with the angular cli and currently deployed in our sb-tools Kubernetes cluster in AWS.

Using RiverIce:

1. Navigate to https://riverice.smashinglabs.net

2. Select “Login” in the top right corner.

3. You will be redirected to github and asked to authorize the application for use in your github account.

Figure 1: Authorize RiverIce to access Github

1. Once you authorize the app, you will be redirected back to RiverIce.

2. On the Create Repository screen, enter repository information:

   1. Select “Product” or “Service”

   2. Enter the Customer name

   3. Enter the Product name

   4. Enter the Subsystem name

   5. Enter the Subsystem type

Note	subsystem types include API, web application, command line application, mobile application, desktop application, and service. Each subsystem type will append a different string to the repository name:

1. API: "-api"

2. Web: "-www"

3. Command line: "-cli"

4. Mobile/ Desktop apps: "-app"

5. Service: "-svc"

Figure 2: Entering information as above will create a repository named smashingboxes-rivericeguide-angular-www

1. Select submit. The next screen should confirm your repository was successfully created. If applicable, a new team will be created using the value of the "customer name" field. You will also be able to add additional members to the new team on this screen.

2. Navigate to Github, to confirm you repository was successfully created.

Figure 3: Successful Creation of a new repository using RiverIce