DEPLOY.md

Hugging Face Spacesへのデプロイ手順

前提条件

• Hugging Faceアカウントを持っている
• Gitがインストールされている

手順

1. Hugging Face Spacesで新規Spaceを作成

1. https://huggingface.co/spaces にアクセス
2. 「Create new Space」をクリック
3. 以下を設定：
   • Space name: security-guard-matching（任意）
   • License: MIT
   • SDK: Docker
   • Space hardware: CPU basic（無料枠）
4. 「Create Space」をクリック

2. リポジトリをクローン

git clone https://huggingface.co/spaces/YOUR_USERNAME/security-guard-matching
cd security-guard-matching

3. ファイルをコピー

以下のファイルをリポジトリにコピー：

• Dockerfile
• README.md
• app.R
• contract_list.csv
• guard_master.csv
• availability.csv

4. プッシュ

git add .
git commit -m "Initial deployment"
git push

5. ビルド確認

• Hugging Face Spacesのページでビルドログを確認
• 数分でアプリが起動します

トラブルシューティング

ビルドが失敗する場合

Rパッケージのインストールエラー

# Dockerfileで依存ライブラリを追加
RUN apt-get update && apt-get install -y \
    libcurl4-openssl-dev \
    ...

アプリが表示されない場合

• ポートが7860になっているか確認
• host='0.0.0.0' が設定されているか確認

メモリ不足の場合

• Hugging Face Spacesの設定でハードウェアをアップグレード
• または、データを軽量化

ローカルでのテスト

# Dockerイメージをビルド
docker build -t shiny-guard-matching .

# コンテナを起動
docker run -p 7860:7860 shiny-guard-matching

# ブラウザでアクセス
# http://localhost:7860

ファイル構成

security-guard-matching/
├── Dockerfile          # Dockerビルド設定
├── README.md           # Hugging Face用メタデータ
├── app.R               # Shinyアプリ本体
├── contract_list.csv   # 契約データ
├── guard_master.csv    # 警備員マスタ
├── availability.csv    # 勤務可否データ
└── DEPLOY.md           # この手順書