Bitriseにあなたのアプリを追加すると、リポジトリをクローンしてアクセス出来ることを確認します。リポジトリのクローンのほかに、サポートされているすべてのアプリケーションを検出しアプリをビルドして配布するのに必要なワークフローを設定するため[プロジェクトスキャナ](https://github.com/bitrise-steplib/steps-project-scanner)を実行します。
Bitriseに新しいアプリを追加するには、[ダッシュボード](https://bitrise.io/dashboard)に移動し、Add new app
ボタンを押します。
これが最初のアプリケーションの場合、ダッシュボードにはあなたのアプリ一覧の代わりにクイックスタートガイドが表示されます。そこにすぐ最初のアプリを追加することができます。
レポジトリへのアクセス ⚓
新しいアプリの追加を選択すると、Create app
ページが表示されます。
まずアプリのプライバシー設定を、パブリックまたはプライベートから選択してください。
- プライベート設定のアプリは、あなたとあなたの組織に所属するメンバー、およびこのアプリに招待された人のみがアクセスできます。このアプリのリポジトリにアクセスするためには、認証が必要です。
- パブリック設定のアプリは、その
bitrise.yml
とビルドのログが公開されます。パブリック設定のアプリのビルドURLがある場合、トラブルシューティングを支援するためにビルドログも閲覧できます。パブリック設定のアプリは認証が必要ないため、SSHキーはありません。
Bitriseには、あらゆるGitリポジトリに接続するためのオプションがあります。GitHub
とGitLab
、Bitbucket
に接続する場合は、特別な追加設定は不要です。
例えば、すでにGitHubでBitriseを認証している場合、Bitriseは自動であなたのすべてのリポジトリを一覧表示します。あとはその中から接続したいもの選択するだけです。
あなたのリポジトリをホストしているプロバイダでBitriseを認証 していない場合、リポジトリは許可を要求します。
上の図のようにリポジトリは一覧で表示されます。もしGitHubやBitbucket以外でホストされているリポジトリに接続したい場合は、Other / Manual
を選択してください。
接続したいリポジトリのGit URLを入力してください。
この後のステップで、BitriseはあなたのリポジトリにSSHキーを追加します。 SSHキーを自動または手動で追加する方法について詳しくはSSH keysをご覧ください。
SSHキーの設定 ⚓
SSHキーはサービス間でのセキュアな情報転送を担います。Bitriseにおいては、GitHubなどのプロバイダでの認証のためにあなたの許可を求めます。Bitriseを認証する方法について詳しくはこちらをご覧ください。
認証が必要となる理由は、Bitriseがあなたのリポジトリからクローンする際にSSH通信を行うためです。セットアップはいくつかの方法で行うことができます。自動または手動セットアップ、あるいは自分で生成したSSHキーを使用する方法があります。
自動セットアップ ⚓
GitHub、GitLabおよびBitbucketのリポジトリをセットアップする場合、BitriseはSSHキーペアを生成します。リポジトリへのSSHキーの登録は、デプロイキーとして自動で行うか、または手動で行うことができます。
キーを自動で登録するためには、リポジトリの管理者権限が必要です。権限がない場合は、公開鍵をコピーしてリポジトリに登録してください。
自動登録の場合、読み取り専用のデプロイキーとしてリポジトリに登録されます。これは最も安全な方法です。
手動セットアップ ⚓
非公開の依存関係やサブモジュールがある場合、生成されたSSHキーを手動でプロバイダに設定する必要があります。これは、デプロイキーはそれぞれ1つのリポジトリにのみ有効であるからです。
追加のプライベートリポジトリを使用する必要があるかを確認されたら、I need to
をクリックし、SSHキーをコピーしてください。
GitHub ⚓
Bitbucket ⚓
GitLab ⚓
自分で生成したキーを使用する ⚓
このオプションは、特定のユーザの秘密鍵を持っている場合に利用できます。秘密鍵をペーストするだけで、Bitriseはリポジトリにアクセスできるようになります。
プロジェクトに SSHキーの設定 がなされれば、 Bitriseはコードをダウンロードし、レポジトリにアクセスできることを確認します。そして、自動的にコードをスキャンし、もっとも最適なプロジェクトの初期設定を検知しようとします。 現時点でBitriseは、iOS
, Android
, Xamarin
および fastlane
のプロジェクトに対応しています。
他のプロジェクトの設定も可能ですが、手動での設定が必要になります。
プロジェクトの自動設定 ⚓
デフォルトのブランチとして、プロジェクトが含まれるレポジトリのブランチ名を入力してください。このブランチには、プロジェクトの設定が含まれている必要があります。一度、Next(次へ)
を押すと、Bitriseは自動でレポジトリの検証を始めます。
検証中に、Bitriseは設定したSSHキーを使って、指定されたブランチへアクセスできることを確認します。
検証が成功すると、Bitriseはレポジトリをスキャンし、プロジェクトの設定に基づいたデフォルトワークフローを提示します。
プロジェクトの手動設定 ⚓
検証が失敗した場合、Restart scanning without validation(検証せずに再スキャン)
を選んでください。
この場合は、手動で設定を行う必要があります。Next(次へ)
をクリックしてください。再びValidating Repository(レポジトリの検証)
という文言が表示されますが、この回ではBitriseは、指定されたレポジトリにアクセスができることのみの検証を行います。
プロジェクトの種別(例えばXamarin)を選んで、必要な情報(例えばXamarinソリューションファイルのパス)を入力してください。ビルドを行いたいスタックを選択することもできます。
Webhook の設定 ⚓
プロジェクトの設定が完了すれば、すぐにwebhookの登録が可能になります。webhookが設定されていれば、レポジトリ内のコードの変更があれば、自動的に作成されたprimary(プライマリ)
ワークフローがデフォルトで起動されます。
webhooksについて詳しくは、Webhooksの章をお読みください。