sugitora's picture
Upload 7 files
1667bfc verified
# 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. リポジトリをクローン
```bash
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. プッシュ
```bash
git add .
git commit -m "Initial deployment"
git push
```
### 5. ビルド確認
- Hugging Face Spacesのページでビルドログを確認
- 数分でアプリが起動します
## トラブルシューティング
### ビルドが失敗する場合
**Rパッケージのインストールエラー**
```dockerfile
# Dockerfileで依存ライブラリを追加
RUN apt-get update && apt-get install -y \
libcurl4-openssl-dev \
...
```
### アプリが表示されない場合
- ポートが7860になっているか確認
- `host='0.0.0.0'` が設定されているか確認
### メモリ不足の場合
- Hugging Face Spacesの設定でハードウェアをアップグレード
- または、データを軽量化
## ローカルでのテスト
```bash
# 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 # この手順書
```