Skip to content

Commit 67bcfe9

Browse files
authored
Merge pull request #7 from NarrativeScience/update-docs
Update docs to reflect change in auth
2 parents 880cdaa + b8c24dc commit 67bcfe9

File tree

4 files changed

+22
-23
lines changed

4 files changed

+22
-23
lines changed

README.md

Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -12,13 +12,13 @@ Additional features:
1212

1313
The commands in the orb will expose the following environment variables:
1414

15-
* `GITHUB_PR_BASE_BRANCH` - The base branch for the PR.
16-
* `GITHUB_PR_NUMBER` - The number of the PR.
17-
* `GITHUB_PR_TITLE` - The title of the PR.
18-
* `GITHUB_PR_COMMIT_MESSAGE` - The current commit's message.
19-
* `GITHUB_PR_AUTHOR_USERNAME` - The PR author's username.
20-
* `GITHUB_PR_AUTHOR_NAME` - The PR author's name.
21-
* `GITHUB_PR_AUTHOR_EMAIL` - The PR author's email address.
15+
- `GITHUB_PR_BASE_BRANCH` - The base branch for the PR.
16+
- `GITHUB_PR_NUMBER` - The number of the PR.
17+
- `GITHUB_PR_TITLE` - The title of the PR.
18+
- `GITHUB_PR_COMMIT_MESSAGE` - The current commit's message.
19+
- `GITHUB_PR_AUTHOR_USERNAME` - The PR author's username.
20+
- `GITHUB_PR_AUTHOR_NAME` - The PR author's name.
21+
- `GITHUB_PR_AUTHOR_EMAIL` - The PR author's email address.
2222

2323
All these commands will work out-of-the-box in jobs using the
2424
[`machine` executor](https://circleci.com/docs/2.0/executor-types/#using-machine).
@@ -34,31 +34,30 @@ or your [Project's Environment Variables](https://circleci.com/docs/2.0/env-vars
3434
It's recommended to create a service GitHub user with at least Read access to your
3535
repository and set the following environment variables:
3636

37-
* `GITHUB_USERNAME` - Username of the service user that has read/write permissions to the repo.
38-
* `GITHUB_PASSWORD` - Password of the service user.
39-
* `GITHUB_EMAIL` - Email of the service user.
40-
* `GITHUB_TOKEN` - API token for the GitHub user
37+
- `GITHUB_USERNAME` - Username of the service user that has read/write permissions to the repo.
38+
- `GITHUB_EMAIL` - Email of the service user.
39+
- `GITHUB_TOKEN` - API token for the GitHub user
4140

4241
### Enabling Slack Notifications
4342

4443
To use the Slack related orb commands, create or use an existing
4544
[workspace bot](https://slack.com/help/articles/115005265703-Create-a-bot-for-your-workspace)
4645
and set the following environment variables:
4746

48-
* `SLACK_OAUTH_TOKEN` - [OAuth token](https://api.slack.com/docs/token-types#bot) for the Slack
49-
bot that will be used to send Slack messages.
47+
- `SLACK_OAUTH_TOKEN` - [OAuth token](https://api.slack.com/docs/token-types#bot) for the Slack
48+
bot that will be used to send Slack messages.
5049

5150
The bot user will need at least the following bot token scopes:
5251

53-
* [`chat:write`](https://api.slack.com/scopes/chat:write)
54-
* [`chat:write.public`](https://api.slack.com/scopes/chat:write.public)
55-
* [`users:read`](https://api.slack.com/scopes/users:read)
56-
* [`users.profile:read`](https://api.slack.com/scopes/users.profile:read)
57-
* [`users:read.email`](https://api.slack.com/scopes/users:read.email)
58-
* [`im:write`](https://api.slack.com/scopes/im:write)
52+
- [`chat:write`](https://api.slack.com/scopes/chat:write)
53+
- [`chat:write.public`](https://api.slack.com/scopes/chat:write.public)
54+
- [`users:read`](https://api.slack.com/scopes/users:read)
55+
- [`users.profile:read`](https://api.slack.com/scopes/users.profile:read)
56+
- [`users:read.email`](https://api.slack.com/scopes/users:read.email)
57+
- [`im:write`](https://api.slack.com/scopes/im:write)
5958

6059
Messages show as being sent by the user associated with the `SLACK_OAUTH_TOKEN`.
6160

6261
#### Example notification
63-
<img width="714" alt="Screen Shot 2020-06-03 at 21 55 38" src="https://user-images.githubusercontent.com/29710511/83716664-29337f00-a5f6-11ea-988f-898093d2ae90.png">
6462

63+
<img width="714" alt="Screen Shot 2020-06-03 at 21 55 38" src="https://user-images.githubusercontent.com/29710511/83716664-29337f00-a5f6-11ea-988f-898093d2ae90.png">

src/commands/build-prospective-branch.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
description: |
22
Builds the prospective merge branch by merging the head branch into the pull request's base branch.
3-
Requires `GITHUB_EMAIL`, `GITHUB_USERNAME`, and `GITHUB_PASSWORD` to be set as environment variables.
3+
Requires `GITHUB_EMAIL`, `GITHUB_USERNAME`, and `GITHUB_TOKEN` to be set as environment variables.
44
parameters:
55
force:
66
description: |

src/commands/get-pr-info.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |
77
* `GITHUB_PR_AUTHOR_USERNAME` - The PR author's username.
88
* `GITHUB_PR_AUTHOR_NAME` - The PR author's name. (Optional)
99
* `GITHUB_PR_AUTHOR_EMAIL` - The PR author's email address. (Optional)
10-
Requires `GITHUB_EMAIL` and `GITHUB_PASSWORD` to be set as environment variables.
10+
Requires `GITHUB_TOKEN` to be set as an environment variable.
1111
parameters:
1212
get_pr_author_email:
1313
description: |

src/commands/post-pr-comment.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
description: |
22
Post a comment on the pull request.
3-
Requires `GITHUB_USERNAME` and `GITHUB_PASSWORD` to be set as an environment variables.
3+
Requires `GITHUB_TOKEN` to be set as an environment variable.
44
parameters:
55
comment:
66
description: Content of the comment to post

0 commit comments

Comments
 (0)