# ダッシュボードでアプリをデプロイする

ダッシュボードを使用して、Android アプリをデバイスにデプロイする方法をご紹介します。

Stripe はアプリのデプロイをレビューして承認を終えると、ダッシュボードを介してメールでお客様に[通知](https://docs.stripe.com/terminal/features/apps-on-devices/submit.md#monitor-status)します。その後、以下の手順に従ってアプリをデプロイできます。

デプロイ中、アプリはすぐにデバイスに送信・ダウンロードされ、デバイスの再起動後にインストールされます。デバイスは 24 時間ごとに再起動し、更新プログラムが自動的に適用されます。更新プログラムをすぐに確認・適用する場合は、デバイスを手動で再起動します。

Terminal デバイス用の新しいアプリや更新されたアプリを、ダッシュボードでデプロイできます。

## デプロイグループを追加または編集する

デプロイグループを追加または編集する前に、Terminal の[店舗](https://docs.stripe.com/terminal/fleet/locations-and-zones.md)を作成し、その店舗に[リーダー](https://docs.stripe.com/api/terminal/readers/object.md)を追加する必要があります。その後、店舗をデプロイグループに割り当てると、その場店舗のすべてのリーダーがそのデプロイグループから更新を受信するようになります。

デプロイグループを作成した後は、それを選択していつでも編集できます。

### デプロイグループを追加する

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、**デプロイグループの管理** をクリックします。
1. **デプロイグループを追加**をクリックします。
1. **デプロイグループを追加**ドロワーで次の手順を実行します。
   - グループ名を入力します。
   - Terminal のデバイスタイプを選択します。
   - 必要に応じて、**デフォルトのデプロイグループ**チェックボックスを選択して、デフォルトのデプロイグループを作成します。デフォルトのデプロイグループには、別のデプロイグループに明示的に割り当てられていないすべての店舗が自動的に含まれます。デバイスタイプごとにデフォルトのデプロイグループを 1 つ作成できます。
   - **完了**をクリックします。

### デプロイグループを管理する

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、**デプロイグループの管理** をクリックします。
1. リストからデプロイグループを選択します。
1. **店舗を追加**をクリックします。
1. 追加する店舗を選択します。
1. **完了**をクリックします。

### ダイレクト支払いでデプロイグループを管理する

プラットフォームは、連結アカウントが所有する店舗をプラットフォームのデプロイグループに追加できます。

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、**デプロイグループの管理** をクリックします。
1. リストからデプロイグループを選択します。
1. **店舗を追加**をクリックします。
1. アカウントのドロップダウンで、店舗を追加する元となるアカウントを選択します。店舗を追加する前に、アカウントを選択する必要があります。
1. 追加する店舗を選択します。
1. **完了**をクリックします。

## アプリのバージョンをデプロイする

[Stripe のレビュー担当者が承認](https://docs.stripe.com/terminal/features/apps-on-devices/app-review.md)した後でアプリをデプロイできます。

ダッシュボードでは、次の 3 つの方法のいずれかでアプリをデプロイできます。

- デプロイグループから
- Softwareタブから
- アプリ自体から

### デプロイグループの詳細ページから

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、**デプロイグループの管理** をクリックします。
1. デプロイグループの詳細ページで、**デプロイ**、**新しいデプロイ**の順にクリックします。
1. デプロイする承認済みの各アプリのバージョンを選択し、**次へ**をクリックします。以前のバージョンのアプリをデプロイすることはできません。アプリのバージョンは、現在デプロイされているアプリよりも新しいバージョンである必要があります。
1. ロールアウトプランを選択し、**次へ**をクリックします。
1. 利用するキオスクアプリを選択し、**次へ**をクリックします。これは、Stripe リーダーがオンになったときに起動するデフォルトのアプリです。
1. デプロイの詳細を確認し、**デプロイ**をクリックします。アプリはすぐにデプロイされます。

### Softwareタブから

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、デプロイするアプリを選択します。
1. **デプロイ**をクリックします。
1. 各アプリのバージョンを選択し、**次へ**をクリックします。以前のバージョンのアプリをデプロイすることはできません。アプリのバージョンは、現在デプロイされているアプリよりも新しいバージョンである必要があります。
1. デプロイグループを選択し、**次へ**をクリックします。
1. ロールアウトプランを選択し、**次へ**をクリックします。
1. 利用するキオスクアプリを選択し、**次へ**をクリックします。これは、Stripe リーダーがオンになったときに起動するデフォルトのアプリです。デプロイするアプリが 1 つしかない場合は、代わりにそのアプリを選択します。
1. デプロイの詳細を確認し、**デプロイ**をクリックします。アプリはすぐにデプロイされます。

### アプリの詳細ページから

1. [Software](https://dashboard.stripe.com/terminal/software)タブで、デプロイするアプリをクリックします。
1. アプリの詳細ページで、**バージョンをデプロイ**をクリックします。
1. 承認済みアプリのバージョンと、デプロイする追加アプリをそれぞれ選択し、**次へ**をクリックします。以前のバージョンのアプリをデプロイすることはできません。アプリのバージョンは、現在デプロイされているアプリよりも新しいバージョンである必要があります。
1. デプロイグループを選択し、**次へ**をクリックします。
1. ロールアウトプランを選択し、**次へ**をクリックします。
1. 利用するキオスクアプリを選択し、**次へ**をクリックします。これは、Stripe リーダーがオンになったときに起動するデフォルトのアプリです。デプロイするアプリが 1 つしかない場合は、代わりにそのアプリを選択します。
1. デプロイの詳細を確認し、**デプロイ**をクリックします。アプリはすぐにデプロイされます。

> 3 回試行してもデバイスが更新をインストールできない場合、ユーザーは更新を延期して支払い処理を続行できます。これにより、ユーザーの制御外の技術的な問題が発生した場合でも、支払い機能を維持できます。

## 複数のアカウント間でアプリを共有する

アカウントとの互換性を評価し、この機能にアクセスするために、[営業担当者にお問い合わせください](https://stripe.com/contact/sales)。

複数の Stripe アカウントがあり、複数のアカウントに同じアプリをデプロイする場合は、この機能を使用します。複数のアカウントで 1 つのアプリを共有することで、パッケージ名の一意性やアプリのレビューの重複による制約を回避できます。

アプリを作成して管理するアカウントを 1 つ指定します。新しいアプリバージョンをアップロードできるのは、アプリを所有するアカウントのみですが、他のアカウントはアプリ ID を検索してアプリを表示してデプロイできます。

1. [Software](https://dashboard.stripe.com/terminal/software) タブで、オーバーフローメニュー (⋯ オーバーフローメニュー) をクリックします。
1. **アプリを検索**をクリックします。
1. アプリ ID を入力し、**アプリの詳細を表示**をクリックします。
1. **バージョンをデプロイ**をクリックし、デプロイの詳細を入力します。

## デプロイグループのベストプラクティス

デバイスを複数のデプロイグループに分類して、ソフトウェアを個別に導入し、問題が発生した場合にエラーを隔離できます。デプロイグループの数は、ツール、リスクの許容度、特定のビジネスニーズに応じて、少なくなることも多くなることもあります。

以下のデプロイグループの設定をお勧めします。

- **Alpha**: 内部開発キットまたは内部運用デバイスに対応する店舗が含まれます。
- **Beta**: 少数の実際のユーザーの店舗が含まれます。これらの店舗をランダムまたは意味のある条件 (例: 低リスクの店舗) に基づいて選択したり、または、リスク許容度に基づいてユーザーに `Beta` デプロイグループにオプトインさせることができます。
- **一般**: `Alpha` または `Beta` グループのユーザーを除く、残りすべての実際のユーザーの店舗が含まれます。既定のデプロイグループを使用すると、残りの店舗をそれぞれ手動で割り当てなくて済みます。

アプリをデプロイする準備ができたら、デプロイグループを最もリスクの低いものから最もリスクの高いものに昇格させます。

|   |      |                                                                                                                                      |
| - | ---- | ------------------------------------------------------------------------------------------------------------------------------------ |
| 1 | アルファ | まず、`Alpha` デプロイグループにデプロイし、ユーザーへのリスクを最小限に抑える方法でアプリをテストします。この段階でバグや望ましくない動作があっても、その影響は少数の内部運用デバイスに限定されており、実際のユーザーや実際の支払いに影響することはありません。 |
| 2 | ベータ  | 次に、`Beta` デプロイグループにデプロイします。これにより、あらゆるユーザーをリスクにさらすことなく、アプリを実際のユーザーに公開できます。                                                            |
| 3 | 一般的  | 最後に、すべての問題に対処するか、`Beta` デプロイグループに問題がないことを確認した後、`General` デプロイグループにデプロイします。                                                           |

## 進行中のステージのデプロイグループにアプリをデプロイする

デプロイグループが設定されたら、デプロイグループ内のリーダーに進行中のデプロイでアプリケーションを段階的にロールアウトします。各ステージは、デプロイグループのリーダーの割合が前のステージの割合よりも大きくなるように設定され、最終ステージは常に 100% になります。デプロイには、Stripe で事前定義された計画を使用することも、カスタムの計画を作成して使用することもできます。

### 進行中のデプロイを設定する

段階的なデプロイを設定するには、以下の手順に従います。

1. 目的のアプリの詳細ページに移動し、**バージョンをデプロイする**をクリックし、使用するアプリのバージョンとデプロイグループを選択します。
1. **段階的なデプロイ**で、カスタムプランまたは事前定義されたプランを選択します。
   - デプロイプランの作成後に、各ステージに関連付けられたパーセンテージは編集できません。
1. デプロイプランを確認して、**デプロイ**をクリックします。
1. デプロイは、初期段階に指定されたパーセンテージに従って開始されます。
   - 事前定義されたプランを選択した場合、デプロイは 0% から始まります。Terminal アプリの新しいバージョンを受け取るには、リーダーの次のステージに手動で進める必要があります。
1. デプロイを進めるには、アプリの詳細ページの**デプロイ済みグループ**の下にある**更新**をクリックするか、デプロイグループの詳細ページで**デプロイを編集**をクリックします。次のステージを確認して、計画を進めます。
1. デプロイを一時停止するには、**更新** (デプロイグループページでは**デプロイを編集**) をクリックしてドロワーを開き、**一時停止**をクリックします。そうすると、追加のリーダーに対するアプリケーションのロールアウトが停止します。
   - 展開を一時停止しても、すでにアプリを受け取っているデバイスには影響ありません。現在新しいアプリバージョンをダウンロードまたはインストールしているデバイスは機能を続けます。

段階的なデプロイを使用する際には、次の点に注意してください。

- デプロイは自動的に先に進みません。デプロイプランを手動で進めない限り、デプロイは現在の率のままになります。
- リーダーは、段階的なデプロイプランのステージに含めるために、デプロイグループ内でランダムに選択されます。たとえば、アプリのバージョン 2.0 が現在、デプロイグループ A の 40% にデプロイされている場合、デプロイグループ A のリーダーの 40% はアプリのバージョン 2.0 を使用し、60% は 2.0 以前のバージョンを使用しています。
- デプロイが進むにつれて、新しいバージョンを受け取るリーダーのグループには、前のステージでそのバージョンを受け取ったすべてのリーダーが追加されていきます。
- 新しいデプロイプランを作成するたびに、希望の段階的なデプロイプランを選択する必要があります。ロールアウトの段階は、古いデプロイプランと新しいデプロイプランの間で維持されません。

## 次のステップ

- [デプロイの監視](https://docs.stripe.com/terminal/features/apps-on-devices/monitor.md)