YOUR TURN

YOUR TURN is the frontend for the STUPS infrastructure. It enables you to

  • register your application in Kio
  • discover APIs of other applications (TWINTIP)
  • define your resources and scopes in Essentials
  • add your application into the OAuth security system (mint)
  • search for Docker images in Pier One

At the moment YOUR TURN expects you to provide all of the STUPS infrastructure, but this will change in the future. Then you will be able to configure it so that it only needs the services of your choice (as far as service interdependencies permit, e.g. mint checking back with Kio if an application exists in the first place).

The UI consists of three modules:

  • The search
  • Applications (using Kio, TWINTIP, mint)
  • Resource Types (using essentials)

They can be accessed via the sidebar, which also hosts information about the current user (via the provided OAuth token).

../_images/yourturn-sidebar.png

Application

At first you will see applications from Kio divided into

  1. applications owned by your team and
  2. applications owned by other teams
../_images/yourturn-application-list.png

You can create a new application:

../_images/yourturn-application-form.png

The ID of the application has to be unique, ie. YOUR TURN will check in Kio if it exists already.

You can get an overview of an application’s data:

../_images/yourturn-application-detail.png

Under “OAuth Client” you define the redirect URL of your application and which scopes it can ask for:

../_images/yourturn-oauth-form.png

Under “Access Control” you configure what scopes your application “just gets” and where berry should pull the credentials from:

../_images/yourturn-access-form.png

“Versions” brings you to the application versions.

Application Version

At first you see the list of all application versions.

../_images/yourturn-version-list.png

You can create a new version:

../_images/yourturn-version-form.png

YOUR TURN will enforce a unique version ID.

You can view the notes and deployment artifact for a version:

../_images/yourturn-version-detail.png

Application Version Approval

Under “Approvals” you can add an approval for this application version:

../_images/yourturn-approval-form.png

There are four default approval types:

  • SPECIFICATION: Approves that tickets in this version are properly specified and have useful content.
  • CODE_CHANGE: The approver asserts that there are no unwanted code changes, i.e. did a code review (via PR or some other means).
  • TEST: The approver asserts that all tests are okay, however they look like for this application (manual, automated, unit…).
  • DEPLOY: The approver asserts that the code inside the deployment artifact of this version is good to deploy.

In addition to that you can define your own approval type (CUSTOM).

Note that all approvals will be deleted when you edit this version, e.g. change the deployment artifact or the notes.

Resource Types

At first you will see all existing resource types.

../_images/yourturn-resource-list.png

You can create a new one:

../_images/yourturn-resource-form.png

Of course the ID has to be unique again.

You can view details of a resource type:

../_images/yourturn-resource-detail.png

You can create new scopes:

../_images/yourturn-scope-form.png

If the resource has an owner, you can select a scope to be a Resource Owner Scope (it has to be requested by the resource owner). If it’s not, the scope can only be an Application Scope. Those you can assign to an application in its “Access Control” panel.

And of course you can view details of a scope, along with the applications that use it:

../_images/yourturn-scope-detail.png