> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/apurikshon/packages/package-updates.md).

# パッケージの更新と自動化

RealmJoin Package Store パッケージの新しいバージョンを、手動または自動でロールアウトし、必要に応じてパイロット ユーザー向けのプレビュー段階を設けられます。

Package Store で、購読しているパッケージの新しいバージョンが提供された場合、手動で展開することも、RealmJoin に自動で実行させることもできます。Managed packages は、段階的なロールアウトをサポートします。 **プレビュー** グループ。

## プレビューを使用した段階的更新

Managed packages では、RealmJoin はパッケージの 2 つのバージョンを並行して保持します:

* **メイン** - Main および Available グループ、つまりユーザーとデバイスの大半に割り当てられているバージョン。
* **プレビュー** - Preview グループにのみ割り当てられる新しいバージョン。たとえば、最初にテストするパイロット ユーザー向けです。プレビューはパッケージの別インスタンスであり、プレビュー実行中のみ存在します。

典型的な更新サイクルは次のとおりです:

1. Package Store に新しいバージョンが表示されます。
2. 新しいバージョンはプレビューとして開始され、Preview グループのメンバーによってテストされます。
3. プレビューがメインに適用されます。その他のすべてのユーザーとデバイスに新しいバージョンが配布され、プレビューは終了します。

[パッケージ管理](https://docs.realmjoin.com/ja/apurikshon/packages/package-management.md) 各パッケージのメイン版、プレビュー版、およびストア上の最新バージョンを表示します。

## パッケージを手動で更新する

Package Store が環境に展開されているものより新しいバージョンを提供している場合、 **更新** の［概要］タブにあるセクションで管理します [パッケージの詳細ページ](https://docs.realmjoin.com/ja/apurikshon/packages/package-details.md) 利用可能な操作が表示されます。

Managed packages では:

* 実行中のプレビューがない場合: **最新の更新をメインに適用** または **最新の更新をプレビューで開始**
* プレビューが実行中の場合: **プレビューをメインに適用**、さらにストアにそれより新しいバージョンがある場合は、 **実行中のプレビューをストア版で更新**

Basic packages では次のみを提供します **更新を適用**.

更新には次が必要です: `CanSubscribeApp` と `CanUpgradeApp` [アクセス許可](https://docs.realmjoin.com/ja/to/permission/custom-roles/available-permissions.md)。メインを更新するには、少なくとも 1 つの割り当て済み Main グループが必要です。

### 別のバージョンを選択

既定では、更新は常に Package Store の最新バージョンを対象にします。特定のバージョンを飛ばしたい、または特定のものが必要な場合は、 *別のバージョンを選択* 更新ボタンの下にあるドロップダウンをクリックします。条件を満たすバージョンが一覧表示され、最新のものには「(latest)」が付いています。1 つ選択し、確認します。 *更新*。Managed packages では、ターゲットごとに 1 行あります: *メイン*, *プレビュー* （プレビューを開始）および *プレビューを更新* （既存のプレビューを移動）。

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-b2224f23c86474e5894aab9b2608955b909ee3c6%2Fpkg-update-choose-version.png?alt=media" alt="Update section with Choose another version expanded"><figcaption><p>別のバージョンを選択</p></figcaption></figure>

このオプションは、次のすべてに該当する場合にのみ表示されます:

* パッケージが Package Store から購読されており、更新が利用可能です（ *更新* そのセクションが表示されます）。
* このパッケージでは、現在更新やその他の操作は実行されていません。
* Package Store には **2** そのスロット（メインまたはプレビュー）に現在展開されているバージョンより新しいバージョンが少なくとも 2 つあります。新しいバージョンが 1 つだけの場合、通常の更新ボタンで既にそのバージョンが対象になります。
* 対象は *メイン*: **メイン チャネルを自動化** はオフです。 *プレビュー*: **プレビュー チャネルを自動化** はオフです（ [自動化](#automation)）。実行中のプレビューの更新は、自動化の影響を受けません。

### ダウングレード

{% hint style="warning" %}
**ダウングレードはできません。** ドロップダウンには現在展開されているものより新しいバージョンのみが表示され、バックエンドは古いバージョンを対象とする更新を拒否します。古いバージョンを展開するには、Package Store でそのバージョンの項目を開き（ [バージョン タブ](https://docs.realmjoin.com/ja/apurikshon/packages/package-store.md#versions-tab) 各変更履歴の行を対応するストア項目にリンクします）、そこから購読してください。各パッケージ ID は 1 回しか購読できないため、まず既存の購読を削除する必要があります。
{% endhint %}

### デバイスが新しいバージョンを取得する仕組み

割り当てられたバージョンを変更しても、すべての場所でパッケージが再インストールされるわけではありません:

* 既存のインストールが新しいバージョンに従うのは、 [自動アップグレード](https://docs.realmjoin.com/ja/apurikshon/packages/package-settings.md#expert-settings) そのパッケージで有効になっている場合のみです。パッケージを初めてインストールするデバイスには、常に割り当てられたバージョンが適用されます。
* RealmJoin Agent は、クライアント ポリシーが [パッケージのダウングレードを許可](https://docs.realmjoin.com/pages/f0841f47e7a0bf26609cf485da2937739863be17#softwarepackaging.autoupgradecandowngrade) に設定されていない限り、デバイスに既にインストールされている新しいバージョンを置き換えません。
* Intune では、Auto upgrade は Required の割り当てのみを更新します。Available アプリを最新に保つには、 [更新グループ](https://docs.realmjoin.com/ja/apurikshon/packages/update-group.md).

## 自動化

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F1Duh3V6W8VZAADCEeeym%2Fimage.png?alt=media&amp;token=124897e6-9769-49f0-a84b-0249fcd7653f" alt=""><figcaption><p>パッケージ自動化</p></figcaption></figure>

Managed packages では、 **自動化** このタブで、RealmJoin が新しいストア バージョンを自動的に展開できるようになります。

* **メイン チャネルを自動化** - 新しいバージョンをメインに自動的に展開します。プレビューが実行中の場合は、プレビューをメインに適用します。
* **… X 日延期** - メインの自動ステップの前に、この日数（0～90）待機します。新しいストア バージョンの場合は、ストアでの公開日からの日数を数えます。実行中のプレビューの場合は、プレビュー開始時点から数えます。
* **プレビュー チャネルを自動化** - 新しいバージョンをプレビューとして自動的に開始します。
* **… X 日延期** - 新しいストア バージョンの公開後、プレビューとして開始するまでこの日数（0～90）待機します。
* **Deploy at Night** - 06:00 から 23:00 の間に当たる自動展開を夜間に移動します。
* **対象のタイムゾーンを選択** - 「夜間」を定義するタイムゾーンは *Deploy at Night*です。タイムゾーンがない場合は UTC が使用されます。

延期フィールドが空のままの場合、そのチャネルは自動的には更新されません。新しい購読では [自動化の既定値](https://docs.realmjoin.com/ja/to/general.md#package-automation-defaults) あなたの Tenant の既定値が使用されます。パッケージで自動化を構成すると、そのパッケージではこれらの既定値が上書きされます。

### チャネルの連携方法

* **メインのみ自動化** - 新しいバージョンは、メインの延期期間が過ぎるとすぐにメインへ送られます。手動で開始したプレビューは、メインの延期期間後に自動的にメインに適用されます。
* **プレビューのみ自動化** - 新しいバージョンは自動的にプレビューとして開始されます。テスト後、プレビューを手動でメインに適用します。
* **両方を自動化** - 新しいバージョンはまずプレビューとして開始され、その後メインの延期期間の後にメインへ適用されます。

{% hint style="info" %}
プレビューの実行中は、より新しいストア バージョンに自動的に置き換えられることはありません。次のバージョンがプレビューに入るのは、現在のプレビューがメインに適用された後だけです。これにより、実行中のテストが新しいバージョンによって無効にならないようにします。
{% endhint %}

{% hint style="success" %}
推奨:

* 自動化するのは **メイン チャネル** 事前テストなしでアップグレードできるソフトウェア、たとえば主要ベンダーの Web ブラウザー向けです。
* 両方のチャネル、または **プレビュー チャネル**、展開前にテストしたいソフトウェア向けです。

公開したくないバージョンを飛ばすには、いつでも手動で更新できます。
{% endhint %}

次の [自動化](https://docs.realmjoin.com/ja/apurikshon/packages/package-management.md#columns) Package Management の列には、次の自動更新がいつ行われるかが表示されます。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/apurikshon/packages/package-updates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
