> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ja/roboflow-cloud/dedicated-deployments/startup-scripts.md).

# 起動スクリプト

推論開始前に、専用デプロイメント上で Bash スクリプトを root として実行します。

スタートアップスクリプトは、推論の開始前に Dedicated Deployment 上でパッケージをインストールしたり、データをダウンロードしたりします。モデルやWorkflowで、推論コンテナに含まれていないPythonパッケージ、システムツール、データファイルが必要な場合に使用します。

{% hint style="info" %}
スタートアップスクリプトはデフォルトで無効になっています。 [有効にするには営業担当まで](https://roboflow.com/sales) お問い合わせください。
{% endhint %}

## 概要

スクリプトはBashです。新しいレプリカや再起動を含め、コンテナが起動するたびにrootとして実行されます。その後、推論はroot以外のユーザーとして実行されます。

スクリプトは10分以内に完了する必要があります。エラーが発生するかタイムアウトすると推論は開始されず、コンテナは再試行します。スクリプトの先頭に `set -e` を記述すると、コマンドが失敗した時点で処理が停止します。また、再実行しても安全なように記述してください。

必要なものは何も用意されていません。pipなど、必要なツールは自分でインストールしてください。 `/userdata` 以下のファイルは、コンテナの置き換え時やデプロイメントの一時停止時に失われる可能性があるため、起動のたびに再ダウンロードしてください。スクリプトでエクスポートした環境変数は、推論には引き継がれません。

`INFERENCE_UID` と `INFERENCE_GID` には、推論の実行に使われる数値のユーザーIDとグループIDが格納されています。スクリプトで作成したファイルに推論がアクセスできるよう、これらを使用してください。

```bash
#!/bin/bash
set -e
apt-get update
apt-get install -y --no-install-recommends curl jq python3-pip
python3 -m pip install 'humanize==4.12.3'
mkdir -p /userdata/custom-data
curl --fail --location 'https://YOUR_HOST/data.json' --output /userdata/custom-data/data.json
chown -R "$INFERENCE_UID:$INFERENCE_GID" /userdata/custom-data
```

スクリプトのサイズは最大64 KiBで、NUL文字を含めることはできません。

## Webアプリ

「Create a Dedicated Deployment」ダイアログ、または既存のデプロイメントの設定にある「Startup Script (Bash)」フィールドにスクリプトを入力します。削除するには「Clear Script」を選択します。

スクリプトを保存しても、実行中のコンテナは再起動されません。変更は次回のコンテナ起動時に適用されます。すぐに適用するには、デプロイメントを一時停止してから再開してください。

スクリプトの出力を読むには、デプロイメントで「View Logs」を選択し、新しいログを表示するには「Refresh」を選択します。ダイアログには、全レプリカの過去1時間分から最大300件が表示されます。ログが表示されるまで少し時間がかかることがあります。スクリプトが出力した内容はすべてここに表示されるため、認証情報を出力しないでください。

## 失敗

すべてのレプリカでスタートアップスクリプトが5回連続して失敗すると、デプロイメントは一時停止します。成功すると、そのレプリカの失敗回数はリセットされます。その後、ステータスは「Paused: Startup Script Failures」と表示されます。スクリプトを修正または削除してから、「Resume」を選択してください。リクエストを受信してもデプロイメントは再開されません。

スクリプトが失敗し始めると、Roboflowは「Deployment Alert Recipients」に登録されているワークスペースメンバーにメールを1通送信します。このリストは、「Create a Dedicated Deployment」ダイアログ、または既存のデプロイメントの設定で指定します。リストが空の場合、デプロイメントを作成したユーザーにのみメールが届きます。デプロイメントが復旧するか、スクリプトを変更するまで、同じ失敗についてRoboflowから追加のメールは送信されません。

## HTTP API

Dedicated Deploymentのエンドポイントは、次の場所でホストされています。 `https://roboflow.cloud`。その他のエンドポイントについては、 [Dedicated Deployments](/deployment/ja/roboflow-cloud/dedicated-deployments.md#http-api) をご覧ください。

デプロイメントの作成時にスクリプトを設定するには、 `startup_script` のフィールドに指定します。 [Create a Deployment](/deployment/ja/roboflow-cloud/dedicated-deployments.md#create-a-deployment)。既存のデプロイメントのスクリプトを変更または削除するには、このエンドポイントを使用してください。

{% openapi src="/files/12f47ac52fcb4d41b093da555d4dcfe801f7af8d" path="/update\_startup\_script" method="post" %}
[dedicated-deployments.yaml](https://970637113-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoksNmwps1HmYr8TqHDnX%2Fuploads%2Fgit-blob-5a9ac8d83d243fff919b6268e8440d704e3b93d1%2Fdedicated-deployments.yaml?alt=media)
{% endopenapi %}
