auth-setup

Goldsky 認証とプロジェクトのセットアップ

Goldsky CLI をセットアップし、アカウントを認証して、パイプラインとサブグラフ用のプロジェクトを設定します。

前提条件

• macOS、Linux、または WSL を使用した Windows（バイナリの互換性についてはステップ 1 を参照）
• インターネット接続
• Goldsky アカウント。アカウントの作成はステップ 3 でブラウザー上から行います。独立した手順としてユーザーに登録を案内しないでください。

認証ワークフロー

このワークフローに従い、各ステップを確認してください。コマンドを実行して結果を確認します。

ステップ 1：CLI をインストールして確認する

不足しているツールは自分でインストールしてください。バイナリのインストールや sudo パスワードの入力をユーザーに求めないでください。ステップ 3 では自分でログインを実行します。ユーザーが行うのはブラウザーで承認することだけです。

macOS と Linux（WSL を含む）では、このスキルのディレクトリにある同梱のインストーラーを実行します。パスは自分で特定してください。ユーザーに場所を尋ねないでください。

bash scripts/install.sh

デフォルトでは Goldsky、Compose、Turbo をインストールします。ベース CLI のみが必要な場合は cli を指定します。Compose のみ、または Turbo のみを使用するタスクでは、compose または turbo を指定します。どちらもベースの Goldsky CLI を含みます。このスクリプトは npm install --global --prefix "$HOME/.local" を使用して @goldskycom/cli@^13.17.0（最新の 13.x、13.17.0 以上）をインストールします（sudo も @latest も使用しません）。その後、指定された拡張機能について goldsky compose install と goldsky turbo install を実行します。goldsky turbo install がコマンドとして認識されない場合、終了コード 1 で終了します。リモートのシェルスクリプトをダウンロードしたり実行したりすることはありません。npm がない場合は失敗します。指定された各コマンドのバージョン確認が成功する必要があります。ログインは不要です。

新しいシェル／ツールの呼び出しごとに、認証と以下のプロジェクトコマンドを含め、必ず PATH を復元してください。前回のツール呼び出しでの export は引き継がれません。

export PATH="$HOME/.local/bin:$HOME/.goldsky/bin:$PATH"
goldsky --version
goldsky compose --version
goldsky turbo --version

指定されたコンポーネントのみを確認してください。バイナリがない場合に Turbo の対話型自動インストーラーを起動しないでください。インストーラーまたは必須のバージョン確認が失敗した場合、セットアップが完了したと報告しないでください。

プラットフォームの制限： goldsky turbo install では、公開されている Turbo バイナリの制限が適用されます。代替手段として curl を使わないでください。また、失敗した場合に sudo を求めないでください。現在の Linux Turbo バイナリには x64 と glibc 2.39 以降（Ubuntu 24.04 など）が必要です。現在の Turbo Mac バイナリは Apple Silicon のみを対象としています。Goldsky と Compose は macOS Intel／Apple Silicon および Linux x64／ARM64 向けのバイナリを公開しているため、Turbo をインストールできなくても compose はインストールできます。CLI のエラーを報告してください。Turbo のインストールに失敗した場合、すべてのインストールが成功したとはみなせません。

Windows： 現在、ツールセット全体を実行できるのは WSL 内のみであり、ネイティブの PowerShell や Git Bash では実行できません。Compose には公開された Windows バイナリがありません。3 つすべてのツールを、既存の x64 Ubuntu 24.04 以降の WSL ディストリビューションで使用してください。PowerShell からの実行方法と前提条件については、Windows のセットアップを参照してください。インストール、以降の CLI コマンド、プロジェクトファイル、goldsky login は、同じ WSL 環境内で行ってください。そこで自分でログインを実行します。WSL 自体のインストール／有効化には管理者アクセス権と再起動が必要になる場合があります。この前提条件を常にユーザーの操作なしで自動化できるとは限らないため、そのように断言しないでください。

選択した環境で必要な前提条件は、Bash、npm、CA 証明書、標準的な Unix ユーティリティ、インターネットアクセス、書き込み可能なホームディレクトリです。これらが不足している場合は、インストールに成功したと報告せず、不足している前提条件を報告してください。リモートインストーラーをパイプで実行するために curl をインストールしないでください。

ステップ 2：認証状態を確認する

goldsky project list 2>&1

すでにログイン済み： 出力にプロジェクト ID と名前のテーブルが表示されます。ステップ 4 に進んでください。

未ログイン： 出力に Make sure to run 'goldsky login' が含まれます。ステップ 3 に進んでください。

ステップ 3：ログイン

チャットでユーザーの API トークンを扱わないでください。 会話に貼り付けられたトークンはトランスクリプトに残り、モデルに送信されます。トークンを求めたり、--token を渡したりしないでください。

PATH を復元した状態で、あなた自身が goldsky login を実行し、最大 5 分間そのまま実行しておきます。URL が表示され、ブラウザーが開き、トークンがディスクに書き込まれます。トークンは表示されません。ユーザーがログインを承認するのは、同じマシン上のそのブラウザーだけです。アカウントの作成やプロジェクトの選択もそこで行います。ブラウザーが開かない場合は、表示された URL を自分で開いてください。ブラウザーを開けない場合に限り、その URL をユーザーに伝えてください。

ログインが完了する前にホストによってコマンドが終了された場合は、もう一度実行してください。シェルを使用できない場合に限り、コマンドをユーザーに渡します。その後、確認します（ステップ 4）。

ステップ 4：ログインを確認

ログイン後は必ず確認してください：

goldsky project list

成功： 終了コード 0 で、プロジェクトの表が表示されます

失敗の兆候：

• Make sure to run 'goldsky login' が引き続き表示される
• invalid token または unauthorized

確認に失敗した場合は、もう一度 goldsky login を実行してください。

完了時の概要

セットアップが正常に完了したら、ユーザーに概要を伝えてください：

## Setup Complete

**What was done:**
- ✓ Goldsky CLI installed (version X.X.X)
- Turbo: verified version, not requested, or explicit installation failure
- Compose: verified version, not requested, or explicit installation failure
- ✓ Authenticated to Goldsky
- ✓ Connected to project: [project-name]

**Your available projects:**
[List projects from goldsky project list output]

**Next steps - try these skills:**
- `/secrets` - Set up credentials for pipeline sinks (PostgreSQL, ClickHouse, Kafka)
- Ask "create a pipeline" to start building data pipelines
- Ask "deploy a subgraph" to deploy a subgraph to Goldsky

ユーザーが何をしようとしているのかまだ伝えていない場合は尋ね、インストール済みのスキルで実行できる作業だけを提案してください。ユーザーが選択して同意するまでは、シークレット、パイプライン、サブグラフ、デプロイメントを作成しないでください。

コマンドリファレンス

コマンド	目的	主なフラグ
goldsky login	Goldsky で認証します	ブラウザーを開きます。--token を渡さないでください
goldsky logout	ローカルの認証情報を削除します
goldsky project list	所属するすべてのプロジェクトを一覧表示します
goldsky project create	新しいプロジェクトを作成します	--name（必須）
goldsky project users list	現在のプロジェクトのユーザーを一覧表示します
goldsky project users invite	プロジェクトにユーザーを招待します	--emails、--role

よくあるパターン

新しいプロジェクトを作成する

goldsky project create --name "my-new-project"

チームメンバーを招待する

goldsky project users invite --emails [email protected] --role Editor

利用可能なロール： Owner、Admin、Editor、Viewer

アカウントを切り替える

goldsky logout
goldsky login
# MUST verify after: goldsky project list

エラーパターン

パターン	意味
Make sure to run 'goldsky login'	認証されていません
invalid token / unauthorized	トークンが正しくないか、期限切れです
Permission denied / 403	ユーザーに必要なロールがありません
token expired / session expired	再認証が必要です

トラブルシューティング

問題	対処
インストーラーが確認または sudo を求める	同梱のインストーラーを使用してください。npm を使って $HOME/.local にインストールするため、sudo は使いません。sudo やリモートシェルスクリプトを使って再試行しないでください
turbo または compose が見つからない、または実行できない	該当コンポーネントの同梱インストーラーを再実行してください。goldsky turbo install がコマンドではない場合は、そこで停止してください。インストーラーを curl しないでください
ログインしていない	あなた自身が goldsky login を実行し、ブラウザーでのログインが完了するまでそのまま実行しておいてください
無効なトークン	もう一度 goldsky login を実行してください。トークンを求めないでください
アクセス拒否	ユーザーはプロジェクトの Owner/Admin にロールの引き上げを依頼する必要があります
セッションの期限切れ	もう一度 goldsky login を実行してください

関連項目

認証が完了したら、次のステップを提案してください：

• /turbo-builder — 対話形式で新しいパイプラインを構築してデプロイします
• /datasets — ユースケースに適したデータセットを探します
• /secrets — パイプラインのシンク用の認証情報を設定します（PostgreSQL、ClickHouse、Kafka など）