@atomist/sdm-pack-rcca-github
An Atomist extension pack to manage GitHub resources like Webhooks
Last updated 7 months ago by atomist .
Apache-2.0 · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install @atomist/sdm-pack-rcca-github 
SYNC missed versions from official npm registry.

@atomist/sdm-pack-rcca-github

atomist sdm goals npm version

Atomist software delivery machine (SDM) extension Pack to manage and converge GitHub resources.

See the Atomist documentation for more information on what SDMs are and what they can do for you using the Atomist API for software.

Usage

Converging GitHub Organizations

Use the Atomist CLI to create or configure your GitHub SCM provider configuration with Atomist:

# To login and connect to Atomist run:
$ atomist config

# If you already have an Atomist workspace you can skip the next step:
$ atomist workspace create

# Finally run the following command to create a GitHub SCM provider:
$ atomist provider create

Once you created the SCM provider, you can now start converging it. To do this, install this extension pack into your SDM:

$ npm install @atomist/sdm-pack-rcca-github

Next register the convergeGitHub pack in your SDM:

import { convergeGitHub } from "@atomist/sdm-pack-rcca-github";

...
    sdm.addExtensionPacks(
        convergeGitHub(),
    );
...

Polling GitHub Organization or User

This pack supports polling for SCM events against GitHub or GHE.

The following steps install and register the extension in your SDM:

$ npm install @atomist/sdm-pack-rcca-github

Next register the convergeGitHub pack in your SDM:

import { watchGitHub } from "@atomist/sdm-pack-rcca-github";

...
    sdm.addExtensionPacks(
        watchGitHub({
            owner: ["atomist", "atomisthq"],
        }),
    );
...

The configuration can also be provided in the client.config.json:

{
  "sdm": {
    "watch": {
      "github": {
        "token": "<your github token>",
        "owner": ["atomist", "atomisthq"],
        "user": false,
        "interval": 60000,
        "apiUrl": "https://api.github.com"        
      }
    }
  }
}

Note: This extension only watches GitHub when the SDM is started in local mode atomist start --local

Support

General support questions should be discussed in the #support channel in the Atomist community Slack workspace.

If you find a problem, please create an issue.

Development

You will need to install Node to build and test this project.

Build and test

Use the following package scripts to build, test, and perform other development tasks.

Command Reason
npm install install project dependencies
npm run build compile, test, lint, and generate docs
npm run lint run TSLint against the TypeScript
npm run compile generate types from GraphQL and compile TypeScript
npm test run tests
npm run autotest run tests every time a file changes
npm run clean remove files generated during build

Release

Releases are handled via the Atomist SDM. Just press the 'Approve' button in the Atomist dashboard or Slack.


Created by Atomist. Need Help? Join our Slack workspace.

Current Tags

  • 0.2.0-master.20190916033632                                ...           branch-master (a month ago)
  • 0.1.0                                ...           latest (7 months ago)
  • 0.2.0-master.20190916033632                                ...           next (a month ago)

89 Versions

Maintainers (1)
Downloads
Today 0
This Week 0
This Month 849
Last Day 0
Last Week 492
Last Month 3,829
Dependencies (5)
Dev Dependencies (16)

Copyright 2014 - 2016 © taobao.org |