GitHubを使ってアプリを作る。
GitHubのリポジトリを、アプリとして動かせます。手元で作って試し、決めたブランチにpushした時点で反映する、という進め方ができます。企画書と設計書を先に書く流れは、「アプリの作り方」と同じです。
GitHubに繋ぐと変わること
- アプリは、繋いだブランチのコードで動きます。
- そのブランチにpushすると、自動で取り込まれて、使っているアプリに反映されます。ほかのブランチでの作業は反映されません。
- 繋いでいる間、ストレージのそのアプリのフォルダは見るだけになります。変更はGitHubで行います。
- 手元で直す
- 繋いだブランチにpushする
- 会話で「@INARY ○○を直して」と頼む
- 承認する
- AIがプルリクエストを出す
- マージする
- 繋いだブランチ
- INARYが自動で取り込む
- 使っているアプリに反映される
繋ぎ方
- 01
GitHubコネクターを接続する
接続は組織の管理者が行います。INARYに見せるリポジトリは、GitHub側の設定で選びます。
- 02
「アプリとして動かす」を押す
INARYのGitHubの画面でリポジトリを開き、「アプリとして動かす」を押します。
- 03
ブランチと作り方を選ぶ
ブランチを選び、「新しいアプリを作る」か「既存のアプリに繋ぐ」を選びます。新しく作るときは、名前と開き方(INARYの中で開く/ブラウザで開く)を選びます。既存のアプリに繋ぐと、そのアプリのファイルはブランチの中身に置き換わります。
INARYで動かすための決まり
手元で作るときも、次の決まりに合わせておけば、そのままINARYで動きます。
- 組み立て方リポジトリのいちばん上に
Dockerfileを置きます。無いときは、package.json・requirements.txt・go.modなどから自動で組み立てます。 - 待ち受け環境変数
PORTの番号で、0.0.0.0でHTTPを待ち受けます。 - データベースいちばん上に
inary.jsonを置いて{"database": "postgres"}と書くと、そのアプリ専用の PostgreSQL が用意され、接続先が環境変数DATABASE_URLで渡ります。表はアプリが自分で作ります。 - ファイル環境変数
DATA_DIRのフォルダに置いたファイルは、作り直しても残ります。同じファイルに同時に書き込むと後から書いたほうが残るので、データベースの代わりには使いません。 - APIキーなどの値INARYのストレージにある、そのアプリのフォルダの「環境変数」に入れ、アプリは環境変数から読みます。コードやファイルに値を書きません。
- AIが読む・操作するためのAPI
GET /inary/capabilitiesで、AIに読ませること・させることの一覧を返し、POST /inary/callでその1つを実行します。 - INARYの中で開くアプリ誰が開いているかを、INARYがヘッダー(
X-Inary-Account-Id・X-Inary-Display-Name(URIエンコード済み)・X-Inary-Is-Administrator)で知らせます。手元ではこのヘッダーが付かないので、試すときは自分で付けます。外のサービスからの通知(Webhook)を受けるパスは、inary.jsonに{"public": ["/webhooks"]}のように書きます。 - ブラウザで開くアプリ組織のメンバーだけが入れるログインの仕組みと、ロボットからのアクセスを断る仕組みを、アプリ自身が持ちます。
INARYから変える
繋いだアプリのコードは、AIに頼んでも変えられます。「@INARY ○○を直して」と送ると、設定の既定では実行前の確認が出ます。承認すると、AIがコードを変えて、繋いだブランチへのプルリクエストを出します。ブランチへ直接書き込んだり、勝手にマージしたりはしません。マージすると、自動で取り込まれて反映されます。
設計書はリポジトリに置いておき、頼むときに「設計書を読んでから」と添えます。
失敗したとき・外すとき
- 取り込みや起動に失敗しても、前の版が動き続けます。GitHubでコードを直してpushすれば、自動で取り込み直します。pushで動かし直した結果は、ストレージのそのアプリのフォルダに出ます。
- 外すときは、INARYのGitHubの画面から外せます。アプリとファイルはそのまま残り、pushしても取り込まれなくなります。ストレージで直せるようになります。
