comment-run
Execute any script in a GitHub issue comment
Say "hello, world"
You can make GitHub Actions Bot to say "hello, world".
Post comment below on your issue or pull request.
For shorter, you can use as follows.
@github-actions run
```js
await postComment("hello, world");
```
Introduce this action
Put .github/workflows/comment-run.yml
to introduce comment-run.
# .github/workflows/comment-run.yml
name: "Comment run"
on:
issue_comment:
types: [created, edited]
jobs:
comment-run:
runs-on: ubuntu-20.04
steps:
- uses: actions/checkout@v3
- uses: nwtgck/actions-comment-run@v2
with:
github-token: ${{ secrets.GITHUB_TOKEN }}
allowed-associations: '["OWNER"]'
You can introduce comment-run with the following command.
mkdir -p .github/workflows && cd .github/workflows && wget https://gist.githubusercontent.com/nwtgck/a9b291f6869db42ecc3d9e30d0a0494c/raw/comment-run.yml && cd -
After introducing this, create new issue or pull request and post @github-actions run
comment.
Comment author who can run scripts
Only accounts who have admin or write permission can execute the comment on your repository. (ref: Collaborators | GitHub Developer Guide)
By default, only owner can execute the scripts. You can change allowed-associations: '["OWNER"]'
in the yaml above.
Here are examples.
allowed-associations: '["OWNER"]'
allowed-associations: '["OWNER", "MEMBER"]'
allowed-associations: '["OWNER", "COLLABORATOR"]'
Learn more: CommentAuthorAssociation | GitHub Developer Guide
Available variables in the js-comment-context
Here are available variables and functions in the ```js
code block.
variable | examples | type or reference |
---|---|---|
context |
context.repo.owner , context.payload.comment |
toolkit/context.ts at @actions/[email protected] · actions/toolkit |
githubToken |
require('@actions/github').getOctokit(githubToken) |
|
octokit |
await octokit.rest.pulls.create(...) , await octokit.graphql(...) |
toolkit/packages/github at master · actions/toolkit |
execSync |
execSync("ls -l") |
child_process.execSync() |
postComment |
await postComment("**hey!**") |
(markdown: string) => Promise<void> , post GitHub issue/pull request comment |
fetch |
await fetch("https://example.com") |
node-fetch/node-fetch: A light-weight module that brings window.fetch to Node.js |
core |
core.debug('my message') |
toolkit/packages/core at master · actions/toolkit |
exec |
await exec.exec("git status") |
toolkit/packages/exec at master · actions/toolkit |
(deprecated) githubClient |
await githubClient.pulls.create(...) , await githubClient.graphql(...) |
toolkit/packages/github at master · actions/toolkit |
Other built-in variables and functions in Node.js such as process
and require(...)
are also available. This means you can use process.env
for environment variables and require('fs')
for file access.
Although other variables not in the list can be used on the comment, comment-run guarantees use of the variables list above and non-listed variables are not guaranteed to use.
Useful examples
LGTM Image
Post random LGTM image with LGTM.in/g.
@github-actions run
<details>
<summary>LGTM 👍 </summary>
```js
const res = await fetch("https://lgtm.in/g", {
redirect: 'manual'
});
const webSiteUrl = res.headers.get('location');
const picUrl = new URL(webSiteUrl);
picUrl.pathname = picUrl.pathname.replace("/i/", "/p/");
postComment(`![LGTM](${picUrl.href})`);
```
</details>
Update all npm packages
Although Dependabot is useful, sometimes you might want to bump all packages up. This comment allows you to do this.
@github-actions run
```js
function exec(cmd) {
console.log(execSync(cmd).toString());
}
// Config
const gitUserEmail = "github-actions[bot]@users.noreply.github.com";
const gitUserName = "github-actions[bot]";
const prBranchName = "comment-run/npm-update";
const baseBranchName = context.payload.repository.default_branch";
exec(`git config --global user.email "${gitUserEmail}"`);
exec(`git config --global user.name "${gitUserName}"`);
exec(`git fetch --all`);
exec(`git checkout ${baseBranchName}`);
exec(`git checkout -b ${prBranchName}`);
const packageJson = JSON.parse(require('fs').readFileSync('package.json'));
const depStr = Object.keys(packageJson.dependencies || {}).join(' ');
const devDepStr = Object.keys(packageJson.devDependencies || {}).join(' ');
exec(`npm i ${depStr} ${devDepStr}`);
exec("git status");
exec("git add package*json");
exec(`git commit -m "chore(deps): update npm dependencies"`);
exec(`git push -fu origin ${prBranchName}`);
await githubClient.pulls.create({
base: baseBranchName,
head: prBranchName,
owner: context.repo.owner,
repo: context.repo.repo,
title: "chore(deps): update npm dependencies",
body: "update npm dependencies",
});
```
PR merge preview
GitHub Actions do not pass secrets
to pull request from forked repositories. This security feature may restricts GitHub Actions usages. This comment is created to resolve the problem
@github-actions run
<details>
<summary>🚀 Merge preview</summary>
```js
// Get pull-req URL like "https://api.github.com/repos/nwtgck/actions-merge-preview/pulls/4"
const pullReqUrl = context.payload.issue.pull_request.url;
const githubUser = context.payload.repository.owner.login;
const res = await fetch(pullReqUrl, {
headers: [
['Authorization', `Basic ${Buffer.from(`${githubUser}:${githubToken}`).toString('base64')}`]
]
});
const resJson = await res.json();
const prUserName = resJson.head.user.login;
const baseBranchName = resJson.base.ref;
const branchName = resJson.head.ref;
const fullRepoName = resJson.head.repo.full_name;
const previewBranchName = `actions-merge-preview/${prUserName}-${branchName}`;
execSync(`git config --global user.email "github-actions[bot]@users.noreply.github.com"`);
execSync(`git config --global user.name "github-actions[bot]"`);
// (from: https://stackoverflow.com/a/23987039/2885946)
execSync(`git fetch --all`);
console.log(execSync(`git checkout ${baseBranchName}`).toString());
console.log(execSync(`git checkout -b ${previewBranchName} ${baseBranchName}`).toString());
console.log(execSync(`git pull https://github.com/${fullRepoName}.git ${branchName}`).toString());
// Push preview branch
// NOTE: Force push (should be safe because preview branch always start with "actions-merge-preview/")
execSync(`git push -fu origin ${previewBranchName}`);
const baseRepoFullName = context.payload.repository.full_name;
// Comment body
const commentBody = `🚀 Preview branch: \n<https://github.com/${baseRepoFullName}/tree/${previewBranchName}>`;
// Comment the deploy URL
await postComment(commentBody);
```
</details>
SSH in GitHub Actions over Piping Server
This comment allows you to go inside of GitHub Actions environment.
@github-actions run
<details>
<summary>🌐 SSH debug over Piping Server</summary>
```js
const crypto = require('crypto');
const pathLen = 64;
const aPath = randomString(pathLen);
const bPath = randomString(pathLen);
const commentUserId = context.payload.comment.user.login;
const clientHostPort = Math.floor(Math.random() * 55536) + 10000;
console.log(execSync(`
chmod 755 "$HOME"
ls -lA /home
authorized_keys_file="$(sshd -T 2>/dev/null | grep -E '^authorizedkeysfile ' | cut -d ' ' -f 2)"
authorized_keys_file="$(cd && realpath -m "$authorized_keys_file")"
sshd_config_dir="$(dirname "$authorized_keys_file")"
(umask 0077 && mkdir "$sshd_config_dir")
echo $authorized_keys_file;
# (from: https://qiita.com/zackey2/items/429c77e5780ba8bc1bf9#authorized_keys%E3%81%AB%E8%A8%AD%E5%AE%9A%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95)
(echo; curl https://github.com/${commentUserId}.keys; echo) >> ~/.ssh/authorized_keys
sudo apt install -y socat;
`).toString());
// Comment new session
const commentBody = `\
## 🌐 New SSH session
Run the command below.
\`\`\`bash
socat TCP-LISTEN:${clientHostPort} 'EXEC:curl -NsS https\\://ppng.io/${bPath}!!EXEC:curl -NsST - https\\://ppng.io/${aPath}'
\`\`\`
Run the command below in another terminal.
\`\`\`bash
ssh -p ${clientHostPort} runner@localhost
\`\`\`
`;
await githubClient.issues.createComment({
issue_number: context.issue.number,
owner: context.repo.owner,
repo: context.repo.repo,
body: commentBody
});
execSync(`socat 'EXEC:curl -NsS https\\://ppng.io/${aPath}!!EXEC:curl -NsST - https\\://ppng.io/${bPath}' TCP:127.0.0.1:22`);
function randomString(len){
const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
const randomArr = new Uint32Array(new Uint8Array(crypto.randomBytes(len * 4)).buffer);
return [...randomArr].map(n => chars.charAt(n % chars.length)).join('');
}
```
## References
* <https://github.com/Cryolite/gha-sandbox/blob/789130f01504a372775be9a2fe4d8df6c4e0ce5c/.github/workflows/ssh.yaml>)
* <https://qiita.com/Cryolite/items/ed8fa237dd8eab54ef2f>
Thanks Cryolite!
</details>
TIPS: Saved replies
"Saved replies" fits this action very much.
You can save "Saved replies" as follows.
Avatar icon > Settings > Saved replies
TIPS: Reactions
Reactions on comments represent the Action is working. Here is a list of the reactions and descriptions.
reaction | reason |
---|---|
👀 | The Action has started looking at your comment. |
👍 | The Action has completed. |
TIPS: Run other languages
This action supports shebang (#!
), so you can run shell and Python as follows.
@github-actions run
```sh
#! /bin/sh
pip install numpy
```
```py
#! /usr/bin/python
import numpy as np
print(np.array([1, 2, 3]))
```
Here are examples.
- Deno: #1 (comment)
- Go: #1 (comment)
- Haskell: #1 (comment)
- Scala: #1 (comment)
TIPS: Use existing package, TypeScript and manage on GitHub
When your comment-run scripts are matured, you might want to use TypeScript for maintainability.
The following repository uses existing npm packages and TypeScript.
https://github.com/nwtgck/comment-run-scripts
Built bundle .js files are hosted on GitHub Pages. So, your comment will be as follows.
@github-actions run
```js
const url = "https://nwtgck.github.io/comment-run-scripts/hello-world-comment.js";
const js = await (await fetch(url)).text();
eval(js);
```