メインコンテンツまでスキップ

新しいプロジェクトの追加

Bitriseへのプロジェクトの追加には、次の2つの方法があります。

  • CI設定で新規プロジェクトを追加し、Gitリポジトリをプロジェクトに接続します。

    この過程で、プロジェクトのプラットフォームタイプ(iOSなど)を検出するプロジェクトスキャナーも実行され、アプリのビルドとデプロイに必要なStepsをすべて含むデフォルトのWorkflowsを生成します。

  • 新しいRelease Managementアプリで新規プロジェクトを追加する: Release Managementに新しいアプリを追加する

各Bitriseプロジェクトはworkspaceが所有します。

プロジェクトスキャナー

プラットフォームやフレームワークをサポートしているとは、プロジェクトスキャナーがプロジェクトの種類を検出し、その種類に基づいて基本的なBitrise設定をセットアップできることを意味します。ビルド方法にかかわらず、他のどのようなプロジェクトも追加できますが、その場合は手動で設定する必要があります。

このガイドでは、新しいCIプロジェクトをBitriseに追加する方法について説明します。

  1. Dashboardで、New projectをクリックします。

  2. Configure Bitrise CIを選択します。

    CI設定の追加エントリーポイント — 開始方法を選択するモーダル

    Release Management

    代わりに新しいアプリをRelease Managementに追加するには、Add your appを選択します。詳細はRelease Managementに新しいアプリを追加するを参照してください。

Add CI configウィザードには、Repository、CI configuration、Build settingsの3つのステージがあります。

リポジトリClick to copy link​

以下の各サブステップを順番に完了してください。

Gitプロバイダーへの接続Click to copy link​

Connect to your Git providerで、Connection methodドロップダウンからconnection methodを選択します。

  • GitHub App (recommended): GitHubアプリ統合を使用して接続します。事前にWorkspaceの管理者がWorkspace settings > Integrationsで認証情報を設定しておく必要があります。詳細はGitHubアプリ統合を参照してください。
  • GitHub OAuth、GitLab、Bitbucket: 各プロバイダー上のアカウントにOAuth経由で接続します。詳細はOAuthによるリポジトリアクセスを参照してください。
  • GitHub Enterprise Server、Bitbucket Server、Self-hosted GitLab: セルフホスト型のGitプロバイダー向けです。
  • Other: URLを手動で入力して、その他のGitリポジトリを接続します。

プロバイダーを選択したら、Connect providerをクリックして接続をset upするか、すでに接続済みの場合はSelect repositoryをクリックします。

Gitプロバイダーへの接続 — GitHub OAuthが選択されたconnection methodドロップダウン

リポジトリの選択Click to copy link​

接続するリポジトリを選択します。

  • Select from list: アカウントのドロップダウンを使用して組織またはユーザーでフィルタリングし、一覧からリポジトリを選択します。特定のリポジトリを検索するには検索フィールドを使用します。
  • Add URL manually: リポジトリのURLを直接入力します。

Confirm selectionをクリックします。

リポジトリの選択 — アカウント別にリポジトリを参照

注記

リポジトリが見つからない場合は、Bitrise OAuthアプリの組織承認をリクエストする必要がある場合があります。リンクはリポジトリ一覧の下に表示されます。

Bitriseの認証Click to copy link​

注記

この手順は、GitHubアプリを使用しておらず、リポジトリがSSH URL経由で接続されている場合にのみ必要です。HTTPS URL経由で接続されたリポジトリでは、SSHキーの設定は不要です。この手順が不要な場合、ウィザードは自動的にスキップします。

Bitriseがリポジトリにアクセスする方法を選択します。

  • Auto-add a generated SSH key to your repository: Bitriseがキーを自動的に追加します。Gitプロバイダーの管理者権限が必要です。
  • Copy a generated SSH key to your Git provider manually: 接続するリポジトリ以外にも、ビルドが追加のプライベートリポジトリにアクセスする必要がある場合に使用します(たとえば、プライベートなCocoaPods specリポジトリ、Fastlane matchのストレージ、Gitサブモジュールなど)。生成されたキーをコピーし、各リポジトリに手動で追加します。
  • Add your own SSH key to Bitrise: 既存のSSHキーペアを使用します。

詳細はSSHキーの設定を参照してください。

Bitriseの認証 — SSHキーのオプション

default branchの選択Click to copy link​

他の設定で別のブランチが指定されていない場合にBitriseがビルドで使用するブランチを選択します。

  • リポジトリが接続されている場合は、ドロップダウンからブランチを選択します。
  • URLを手動で追加した場合は、branch nameを直接入力します。

default branchの変更は後からでも可能です。次のステージに進むにはNextをクリックします。

default branchの選択 — mainが選択されたブランチドロップダウン

CIの設定Click to copy link​

Bitriseがリポジトリをスキャンし、初期のCI設定を自動的に生成します。

CI設定 — リポジトリのスキャン

スキャンが完了すると:

  • プロジェクトの種類が検出された場合、Detected optionsタブに表示されます。
  • プロジェクトの種類が検出されない場合は、Manual setupタブに切り替え、Project typeドロップダウンからプロジェクトの種類を選択します。

CI設定 — プロジェクトの種類の手動選択

自動設定をスキップし、後で手動でセットアップする場合はSkipをクリックします。

ビルド設定Click to copy link​

プロジェクトのビルド設定を確認し、必要に応じて調整します。

  • Build machineとStack: Bitriseがプロジェクトの種類に基づいて最適な設定をあらかじめ選択します。これらは後からWorkflow Editorで変更できます。詳細はBuild machineのタイプおよびビルドスタックを参照してください。
  • Access to builds: Private(ビルドログとCI設定ファイルにはWorkspaceのメンバーのみアクセス可能)またはPublic(リンクを知っている人なら誰でも閲覧可能)を選択します。詳細は公開プロジェクトを参照してください。
  • Register webhooks: このトグルを有効にすると、BitriseがリポジトリにWebhookを自動的に登録し、コードの変更時にビルドがトリガーされるようになります。GitHubアプリを使用している場合は不要です。詳細は受信Webhookの追加を参照してください。

ビルド設定 — マシン、スタック、アクセス、Webhook

Finishをクリックします。Bitriseが最初のビルドを開始し、ビルドページに移動してリアルタイムで実行状況を確認できます。そこからWorkflowsの編集を開始したり、ビルドの実行を行ったりできます。

関連情報