クイックスタート

用意するのは、GitHub の組織か個人アカウントのプライベートリポジトリと、.github/workflows にあるワークフロー一つです。数分で終わり、無料トライアルにカードは要りません。

1. GitHub でログインする

skipbox.dev を開き、GitHub でログインします。ログインしても料金はかかりません。

2. Skipbox のアプリをインストールする

インストールのボタンは二つあります。ジョブを動かしたいアカウントに合わせて選びます。

• 組織: Skipbox CI アプリを入れます。インストールするのは組織のオーナーです。オーナーでなければ、GitHub がオーナーにリクエストを送ります。インストールしたオーナーが一度 Skipbox にログインすると、ジョブが動き始めます。
• 個人アカウント: Skipbox (personal) アプリを入れます。

次に GitHub が、すべてのリポジトリを使わせるか、一部だけにするかを聞きます。Skipbox が動かすのはプライベートリポジトリのジョブだけです。詳しくは組織と個人アカウントとGitHub アプリの権限へ。

3. ジョブの runs-on を書き換える

ワークフローのファイルを開き、ジョブ一つの runs-on を skipbox にします。

jobs:
  test:
    runs-on: skipbox
    steps:
      - uses: actions/checkout@v4
      - run: make test

ダッシュボードにはリポジトリごとにワークフローが並び、「GitHub で編集する」から GitHub のエディターで書き換えられます。

4. コミットして push する

コミットすると、そのジョブの次の実行は Skipbox の新しい VM で動き、ダッシュボードに出ます。無料トライアルはこの最初のジョブから始まり、7日間か 3,000分の早いほうまで使えます。詳しくは無料トライアルへ。

GitHub のランナーに戻す

runs-on を ubuntu-latest など元の値に戻してコミットします。リポジトリのほかの部分を Skipbox が変えることはありません。

次に読む

• 大きい VM を使う：ラベルとサイズ
• VM に入っているもの：ランナーのイメージ
• ジョブが始まらない：ジョブが待機中のまま