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

JenkinsからBitriseへの移行

モバイルCI/CDフローを高速化し、専任の人員を減らすために Jenkins から Bitrise への移行を検討している場合は、このガイドが役立ちます。このガイドでは、Bitrise の最も重要な機能と、Jenkins の環境から Bitrise にすばやく移行する方法を紹介します。

移行するメリットClick to copy link​

Jenkins はセルフホスト型の CI サーバーで、ビルドを実行する前に、ほとんどの機能を手動でインストールして保守する必要があります。また、定期的なメンテナンスに専任のエンジニアリングリソースも必要です。Bitrise に切り替えると、モバイル開発に必要な機能をすべて 1 つのプラットフォームで提供する、クラウドベースでモバイルファーストの CI/CD プラットフォームを手軽に利用できます。つまり、次のとおりです。

  • 何もダウンロードする必要がありません。
  • オンプレミスのサーバーやプラグインは不要です。
  • インフラストラクチャ、ツール、仮想化について心配する必要がありません。

上記のすべてを Bitrise が処理します。自動化された Steps、API、CLI、そして直感的な GUI を備えた最新の Stacks(Workflow Editor)が豊富に用意されており、すべてすぐに利用できます。

セキュリティ対策の詳細については、Security のページをご覧ください。製品、データ、アプリケーション、ネットワーク、物理、ビジネスの各セキュリティに関する詳細が記載されています。

Bitrise で自動化されたモバイル開発の世界をぜひご体験ください。

Bitrise が大手企業の移行をどのように支援したか
  • 決済大手の PagSeguro が、Jenkins から Bitrise に移行してモバイルCIを最適化した方法をご覧ください: 事例を読む。
  • Bitrise と Jenkins の機能別の比較をお探しですか? 比較ページをご覧ください。

クイックスタートガイドClick to copy link​

このクイックスタートガイドでは、最小限の設定で Bitrise で最初のビルドを開始する手順を説明します。

  1. まだアカウントをお持ちでない場合は、Bitrise にサインアップしてください。
  2. リポジトリを接続し、任意のプロジェクトで自動構成された標準の Workflow を実行します。
  3. 生成された YML を確認したら、必要な変更を加えます。カスタムコードを使用する場合は、Script Stepに追加して最初のビルドを実行してください。または、Step Libraryで Steps を見つけて、Jenkinsfile の動作を再現できます。Bitrise のオープンソースランナーである Bitrise CLIをインストールして、ご自身のコンピューター上でローカルにビルドを実行することもできます。
  4. 新しい Workflow で最初のグリーンビルドが成功したら、自動トリガーまたはスケジュールビルドを設定して、他のジョブを構成します。
  5. キー ベースのキャッシュを使用して Workflows を最適化すると、ビルドがより高速で安全になり、再現性も高まります。
  6. サポートが必要な場合は、お問い合わせください。

Jenkins と Bitrise の主な違いや、Bitrise がモバイル開発プロセスをどのように強化するかに関心がある場合は、以下のガイドをお読みください。

Jenkins と Bitrise でのビルドの管理Click to copy link​

Bitrise のビルドは、アプリの Workflowで指定されたプロセスです。これは、Workflow で定義された一連の Stepsで構成され、クリーンな仮想マシン上またはローカルマシン上で Bitrise CLIによって実行されます。アプリのビルドは Bitrise の Dashboard で確認できます。また、アプリ専用の Builds ページでビルドログを分析することもできます。

Jenkins と Bitrise でのビルドのトリガーClick to copy link​

このセクションでは、Bitrise でビルドをトリガーする方法を説明します。

  • Jenkins の Build Now 機能は、ビルドの手動開始に相当します。ビルドページのボタンをクリックして、新しいビルドをそのまま開始するか、詳細設定オプションで細かく調整します。
  • Jenkins の Build periodically 機能は、Bitrise のビルドのスケジュール機能に相当します。Bitrise の大きな利点は、Jenkins のように特定の時刻にスケジュールするための cron ジョブを設定する必要がないことです。代わりに、ビジュアルスケジューラーで曜日と時刻を選択するか、必要に応じて cron 式を直接入力できます。
  • コードのプッシュ、プルリクエスト、Git タグなど、Git に関連するイベントについては、Bitrise でビルドを自動的に開始するトリガーを設定できます。
  • Jenkins の Build after other projects 機能は、Workflows を順次実行する Bitrise の Workflows の連結に相当します。Bitrise では、Workflows を驚くほど簡単に連結できます。
  • 他のリモートシステムからもビルドをトリガーできます。Webhooks の概要をご覧ください。GitHub、Gitlab、Bitbucket、Gogs、Slack、Visual Studio、Assembla、Deveo と連携しています。
  • Git プロバイダー(GitHub/GitLab/Bitbucket)にビルドステータスレポートを送り返すこともできます。

Bitrise の Environment Variables と SecretsClick to copy link​

Environment Variables(キーと値のペア)は、アプリ、Workflow、Steps の各レベルで定義できます。

Env Vars を使って、さまざまなことができます。

  • Env Vars を公開して、別の Step で再利用します。
  • Env Var を別のキーにコピーします。
  • Env Var を上書きします。
  • ビルドにカスタム Env Vars を追加して、ビルドをパラメーター化します。
  • Env Vars タブで Set up Workflow 固有の Env Vars を使用すると、その Workflow でのみ利用できる Env Vars で Workflows を実行できます。

Secrets は Environment Variables の一種ですが、特別なものです。機密情報を暗号化された形式で保持し、入力した非公開の内容がビルドログや bitrise.yml に公開されないようにします。シークレット Environment Variables(略して Secrets)は、Workflow Editor の Secrets タブでキーと変数を追加して設定できます。これも Bitrise の組み込み機能で、次の点を保証します。

  • シークレットが bitrise.yml に表示されません。
  • シークレットは暗号化されて保存されます。
  • シークレットを保護対象にすることで、UI での公開を防止できます。
  • プルリクエストを使った回避策でシークレットの値をログに出力できてしまう場合があるため、PR でシークレットを公開しないことを推奨します。

ビルドのキャッシュClick to copy link​

Bitrise のすべてのビルドはクリーンな仮想マシン上で実行されますが、毎回すべてを一からやり直す必要はありません。重要なファイルの内容をキャッシュして、ビルド間で保持できます。

Jenkins のプラグインと Bitrise StepsClick to copy link​

Stepは、Jenkins Steps と同様に Bitrise で事前に定義されたタスクですが、Bitrise Step は直感的な UI で簡単に設定できます。また、リポジトリから独自の Step を取り込むこともできます。Step のタスクを定義する入力とパラメーターを設定し、Step が生成する出力を確認して再利用できます。出力を再利用するとは、同じ Workflow 内の別の Step が、その出力を自身の入力の値として使用できることを意味します。

Jenkins は継続的インテグレーションツールであるため、プラグインの助けを借りて他のサービスと integrates with します。Jenkins のユーザーは、Manage plugins という一元的な場所でプラグインを管理し、Jenkins サーバーにグローバルにインストールしてから、各プロジェクトで使用する必要があります。Jenkins が新しいバージョンのプラグインを通知しても、プラグインの更新にはサーバーの再起動が必要なため、Jenkins の管理者はビルドを実行中かどうかをチームに確認する必要があります。Jenkins のプラグインでは、最新の latest version しか利用できないため、以前のバージョンに戻すことはできません。一方、Bitrise では、事前に Steps をインストールする必要はありません。Bitrise Workflow に Step を好きなときに追加または削除でき、プロジェクトの実行中のビルドがブロックされることもありません。必要に応じて、以前の Step のバージョンに戻すこともいつでもできます。

さらに、Workflow Editor で Workflow を編集するときに、Step Library で目的の機能やプラットフォームに基づいて Step を検索し、すぐに Workflow に追加できます。Workflow を設定する前にインストールする必要はありません。

独自のカスタム Stepを作成してリポジトリに保存し、Workflow で URL によって参照することもできます。

Step の万能カード: Script Step

Workflow で実行したいカスタムスクリプトはありますか? Step Library から Script Step を選択し、Script content 入力にカスタムコードを追加します。

Steps は、Integrations ページで、または Workflow の編集中に確認できます。

Steps でできるその他のことについては、次をご覧ください。

Jenkins で fastlane を使用していますか?

fastlane の lane は Bitrise でも簡単に動かせます。Bitrise の Fastlane Step を Workflow に追加し、lane 名を Step に入力するだけです。ビルドを開始すると、lane が Bitrise で実行されます。

Jenkins Pipeline - Bitrise WorkflowClick to copy link​

Jenkins Pipeline は Bitrise Workflowに相当しますが、Bitrise Workflows の方がはるかに簡単に管理できます。既存のものをもとに新しい Workflows をすばやく作成したり、複数の Workflows を 1 つのビルドで連結したり、不要になった Workflows を削除したりできます。

Bitrise Workflow は、テスト、code signing、APK/ipa のビルド、デプロイなどの一連の Steps です。Bitrise にプロジェクトを追加すると、プロジェクトスキャナーの検出結果に基づいて作成されたプライマリ Workflow が自動的に開始(トリガー)されます。

1 つのプロジェクトに複数の Workflows を設定できます。例:

  • PR イベントごとに、トリガーされると高速に実行され、スモークテストなどの基本的なテストのみを実行する Workflow を作成します。
  • すべてのテストを実行する本格的な Workflow には、別の Workflow を作成して夜間に実行するか、6/12/24 時間間隔でスケジュールすることを推奨します。

Workflow Editor は、Workflow を設定するための主要な場所です。Jenkins Stage は、メインの Workflow 内で連結された複数の Bitrise Workflows に相当します。Bitrise では、おもちゃの電車を連結するように Workflows を連結するのを Workflow Editor が支援します。

Workflow Editor には、モバイル開発を支援するその他の強力な機能が組み込まれています。

  • Code signing: 証明書、プロビジョニングプロファイル、キーストアを Bitrise にアップロードし、iOSおよび Androidの署名 Steps を使用して、アプリをアプリストアにリリースする前に、すべての code signing を自動的に処理します。
  • Secrets: プロジェクトのシークレット Environment Variables を確認したり、新しく追加したりできます。
  • Environment Variables: Bitrise では、シークレットと Env Vars が混在することはありません。別々のタブにわかりやすく整理されているため、どこに何があるかが一目でわかります。ここでプロジェクトの Env Vars や Workflow 固有の Env Vars を追加できます。Secrets を $ を付けて Env Vars として参照することもできます。
  • Triggers: トリガーを設定できます。コードのプッシュイベント、プルリクエスト、タグのいずれも、Bitrise でビルドを自動的に開始するように設定できます。
  • Stack: プロジェクトのデフォルトのスタックを確認したり、ドロップダウンメニューから新しいスタックを選択したり、Workflows の 1 つに特定のスタックを選択したりできます。

Jenkins と Bitrise の DashboardsClick to copy link​

これは、Bitrise にログインしたときに表示されるメインのランディングページです。ここから、プロジェクト、ご自身の CI ビルド、Bitrise Build Cache、Release Managementに移動できます。

bitrisedashboard.png

Jenkins では、ビルドステータスは Build Executor Status または Blue Ocean の Dashboard に一覧表示されます。Bitrise を使用すると、最初から使いやすいグラフィカルインターフェースを利用できますが、Jenkins では最初にプラグインをインストールする必要があります。Bitrise のビルドステータスは、Dashboard とアプリの Builds ページの両方に表示されます。

Bitrise への新しいアプリの追加Click to copy link​

Jenkins における New item は、Bitrise の adding a new project flow に相当し、Web UIまたはCLI から実行できます。これは高度に自動化されたフローで、必要な設定は最小限であり、文字どおり 1 分以内に新しいビルドが開始されます。このフローでは、プライバシーの設定、リポジトリの接続、リポジトリアクセスの設定、ブランチの選択、プロジェクトの構成、ビルド構成の設定、Webhooks の設定など、すべての重要なフェーズを順に進めます。

Bitrise の WebhooksClick to copy link​

Bitrise は Webhooks を幅広く活用しており、プロジェクトを Bitrise に接続するときに、ワンクリックで有効にできます。初期設定のときに Webhook を追加しておけば、プロジェクトをすばやく軌道に乗せようとするときにこの機能を探し回る必要がなくなります。

Webhooksには、大きく分けて 2 種類があります。

  • Incoming webhooks は、Git サービスプロバイダーに登録され、Bitrise でビルドを自動的にトリガーするために使用されます。
  • Outgoing webhooks は、ビルドイベントのレポートを Slack などの他のサービスに送信するために使用されます。Web サイトから、または API の概要から追加できます。

Jenkinsfile - Bitrise YAMLClick to copy link​

Jenkins Pipeline は groovy コードを使用しますが、Bitrise はより構造化された YAML 形式を使用します。すべての Workflows は、YAML 形式の bitrise.yml ファイルで定義されます。このファイルは、Workflow Editor の bitrise.yml タブをクリックして編集できます。

アプリの bitrise.yml ファイルは、bitrise.io またはリポジトリ内に保存できます。シークレット(認証情報や ID など)は安全に保護されますので、ご安心ください。

bitrise yml get でアプリの現在の bitrise.yml 構成をダウンロードし、Bitrise CLIでローカルに実行することもできます。Bitrise CLI による bitrise.yml の操作をご覧ください。

Jenkinsfile と Bitrise yml ファイルの比較Click to copy link​

Jenkins で Jenkinsfile(Pipeline プロジェクト)を使用していて、Bitrise への切り替えを検討している場合は、Jenkinsfile のステージを Bitrise Steps と簡単に対応付けられます。従来の Freestyle プロジェクトを使用している場合は、構成の設定を、対応する Bitrise Step または Bitrise の機能にマッピングする必要があります。たとえば、Freestyle プロジェクトの Build セクションを、Android Build Step などの Bitrise ビルド Step に対応させたり、Jenkins の Build Trigger セクションを、Bitrise の Triggers機能にマッピングしたりします。さらにヒントが必要な場合は、Step Libraryもご覧ください。

Android アプリを Jenkins から Bitrise に移行する: ステップバイステップガイド

Android プロジェクトを Jenkins から Bitrise に移行する方法については、ブログ記事をご覧ください。

Jenkins のマスターとエージェント - Bitrise スタックClick to copy link​

スタックは、ビルドの実行に使用する仮想マシンの種類です。たとえば、ネイティブ iOS アプリには、Xcode スタックのいずれかが最適です。Stacks には必要なツールがすべてプリインストールされており、あらゆるニーズに対応できるよう定期的に更新されています。そのため、マスターやエージェントのインスタンスを保守したり、特定のプラットフォームでビルドを実行するために groovy コードにノードマシンを追加したりする必要がありません。

Bitrise にアプリを追加すると、プロジェクトセレクターがプロジェクトの種類を自動的に検出し、そのプラットフォームの種類に基づいてデフォルトのスタックを追加します。最初のビルドは、必要なツールがすべてプリインストールされた仮想マシンであるこのスタックで実行されます。別のスタックを使用する場合は、Stacks & Machines タブの Default Stack ドロップダウンメニューから選択するだけです。More information リンクをクリックすると、プリインストールされているツールとそのバージョンを確認できます。

Xcode の最新バージョンは、公式リリースの直後にサポートしています。

システムレポートでは、各スタックにインストールされているツールとそのバージョンを確認できます。

macOS スタックの更新ポリシーについて詳しくご確認ください。

AWS 環境で Bitrise が管理するインフラストラクチャを利用することに関心がある場合は、ガイドをご覧ください。こちらのガイドに従って、self-hosted infrastructure で Bitrise を実行することもできます。

Jenkins と Bitrise でのチームとロールの管理Click to copy link​

Bitrise ユーザーは、Bitrise アカウントを持つ個人で、1 つ以上の workspace に所属します。workspace は、プロジェクトで共同作業を行うユーザーのグループです。複数の workspaces を作成でき、コントリビューターは他の Bitrise のコントリビューターによって複数の workspaces に招待できます。コントリビューターは、プロジェクトで作業するために、そのプロジェクトに割り当てられている必要があります。

既存の workspace メンバーを追加するか、外部のコントリビューターを招待して、Web UI でプロジェクトにコントリビューターを追加する方法をご確認ください。

コントリビューターには、実行できることと実行できないことを決めるさまざまなロールを workspaces で割り当てることができます。

Bitrise で有料のサブスクリプションプランを利用するには、workspace が必要です。workspaces ごとに異なるサブスクリプションプランを設定でき、workspace のプロジェクトで使用できるクレジット数が決まります。

SAML SSO または SCIMを使用すると、エンタープライズを workspace に安全にオンボーディングまたはオフボーディングできます。

Bitrise の統合された SSO 管理Click to copy link​

Jenkins では SSO 管理のために認可プラグインをインストールする必要がありますが、Bitrise では有料プランに不可欠な要素として含まれています。このようなプランを利用している Workspace は、Bitrise 上の Workspace への唯一のゲートウェイとして、SAML SSOを設定できます。ユーザー名や認証情報を覚えておく必要はもうありません。Workspace のオーナーは、SAML SSO プロバイダーで Bitrise を SAML SSO アプリとして設定し、Workspace のメンバーを Bitrise Org に招待するだけです。手順については、さまざまな SAML SSO プロバイダーごとのガイドをご用意しています。