<img src="./images/dockerImageSunburst.png" width="130" hight="130" align="right" />
This pack turns your SDM into a tool for visualizing technology usage and drift across an organization.
The cloud native era has led to an explosion of repositories, which we lack tools to understand and manage at scale. See Rod Johnson's blog This Will Surprise You for further discussion.
When you create an SDM with this pack, you can run it two ways:
An Atomist aspect captures a concern in your project, in anything available from git: repository content (code and configuration) and git data such as branch counts and committer activity. Aspects support the following use cases:
This project focuses on the visualization use case. Visualizations are exposed via sunburst charts and via a REST API returning JSON documents.
There is out of the box support for investigating the following aspects of your project:
Analysis is extensible. Implementing and registering additional aspects will result in additional visualization links after re-analysis and restarting the application.
An example visualization, showing Docker images used across two GitHub organizations:
To try this out, we recommend grabbing the org-visualizer project. It uses this library, and gives you a place to add your own aspects.
If you already have an Atomist SDM, add analysis & visualization of projects by bringing in this pack.
For an example, check how org-visualizer does it:
sdm.addExtensionPacks(
aspectSupport({
aspects: aspects(),
scorers: scorers(),
taggers: taggers({}),
combinationTaggers: combinationTaggers({}),
undesirableUsageChecker: demoUndesirableUsageChecker,
}),
);
You can include any number of aspects, scorers, taggers, etc. Many are defined in this pack. For descriptions of these concepts, try developer.md
In local mode, Atomist aspects are stored in a database. You can either configure your SDM with a preProcessor: startEmbeddedPostgres
or run Postgres on your laptop.
Data about each repository is stored locally in a PostgreSQL database.
Start Postgres, connect to it, and run the create.ddl script to set up the database.
If you want to wipe out your data and start over, this will also accomplish that.
> psql
psql> \i ddl/create.ddl
For anything other than the default Postgres connection parameters and db org_viz
:
Configure the Postgres database details in client.config.json
in your ~/.atomist
:
{
"sdm": {
"postgres": {
"user": "<postgres user>",
"password": "<postgres password",
"host": "<postgres host>",
"port": "<postgres port>",
"database": "org_viz"
}
}
}
If ~/.atomist/client.config.json
does not exist, create it with the above content.
When the server is running with atomist start --local
, you can see the visualizations.
Go to http://localhost:2866.
The analyze
command is part of this pack.
It works as at Atomist command, which runs through the atomist
CLI.
npm i -g @atomist/cli
atomist start --local
To analyze repositories in a GitHub organization (or a GitHub user), run the following command:
atomist analyze github organization
Enter the GitHub owner name (e.g., 'atomist') at the prompt.
_To access private repositories, ensure that your GitHub token is available to
Node processes via a GITHUB_TOKEN
environment variable._
To narrow the repositories, add --search [substring-of-interesting-repos]
You can also analyze repositories across GitHub using atomist analyze github by query
.
The query string is one that would work on GitHub.com.
Use the --cloneUnder [dir]
option to supply a stable directory under which all cloning should be performed.
Otherwise, temporary files will be used.
If using a stable directory, make sure the directory exists and is writable by the
org-visualizer
process. And keep an eye on disk
To analyze local directories, wherever they were cloned from, specify the full path of the parent directory of the repositories, as follows:
atomist analyze local repositories --localDirectories /Users/rodjohnson/atomist/projects/spring-team/
Run
atomist analyze ...
with--update true
flag to force updates to existing analyses. Do this if you have updated your analyzer code. (See Extending below.) usage, as these directories are not transient and will not be deleted automatically.
There are four architectural layers:
atomist analyze
or, in regular use, by an Atomist SDM.This project includes some well known aspects but it is intended for you to add your own.
Do this by updating the aspects
function defined in the aspects.ts
file. Simply add aspects to this array:
export function aspects(): Aspect[] {
return [
DockerFrom,
TypeScriptVersion,
//... add your aspects here
After updating your code you will need to rerun existing analyses. Run
atomist analyze [local|github] --update true
again to force updates on existing data.
See the developer guide for more information.
The Atomist service keeps analyses up to date automatically across all your repositories. It can also help to achieve consistency and convergence in eligible aspects by updating projects, and enabling workflows on change.
See https://atomist.com/developer.html for further information.
Created by Atomist. Need Help? Join our Slack workspace.