アプリの作り方

GitHubを使ってアプリを作る。

GitHubのリポジトリを、アプリとして動かせます。手元で作って試し、決めたブランチにpushした時点で反映する、という進め方ができます。企画書と設計書を先に書く流れは、「アプリの作り方」と同じです。

GitHubに繋ぐと変わること

  • アプリは、繋いだブランチのコードで動きます。
  • そのブランチにpushすると、自動で取り込まれて、使っているアプリに反映されます。ほかのブランチでの作業は反映されません。
  • 繋いでいる間、ストレージのそのアプリのフォルダは見るだけになります。変更はGitHubで行います。
変更が反映されるまで
    1. 手元で直す
    2. 繋いだブランチにpushする
    1. 会話で「@INARY ○○を直して」と頼む
    2. 承認する
    3. AIがプルリクエストを出す
    4. マージする
  1. 繋いだブランチ
  2. INARYが自動で取り込む
  3. 使っているアプリに反映される

繋ぎ方

  1. 01

    GitHubコネクターを接続する

    接続は組織の管理者が行います。INARYに見せるリポジトリは、GitHub側の設定で選びます。

  2. 02

    「アプリとして動かす」を押す

    INARYのGitHubの画面でリポジトリを開き、「アプリとして動かす」を押します。

  3. 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が読む・操作するためのAPIGET /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しても取り込まれなくなります。ストレージで直せるようになります。