oci

Oracle Cloud Infrastructure (OCI)

重大：シークレットと .env

• 稼働中の .env ファイルや認証情報をスキルフォルダー内に絶対に保存しないでください。
• .env.template ファイルは、スキル内の assets/ のみに配置してください。
• 稼働中のシークレットは ~/.admin/.env に保存し、そこを参照してください。

ステータス：本番環境で利用可能 | 依存関係：OCI CLI、SSH 鍵ペア

ナビゲーション

• 操作、トラブルシューティング、設定、クリーンアップ：references/OPERATIONS.md
• CLI のインストール／設定／容量／ネットワークの詳細：references/

ステップ 0：必要な情報を収集する（必須）

停止してください。デプロイコマンドを実行する前に、すべてのパラメーターをユーザーから収集してください。

このチェックリストをコピーし、各項目を確認してください。

Required Parameters:
- [ ] SERVER_NAME       - Unique name for this server
- [ ] OCI_REGION        - Region (us-ashburn-1, us-phoenix-1, ca-toronto-1, etc.)
- [ ] OCI_SHAPE         - Instance shape (see profiles below)
- [ ] OCI_OCPUS         - Number of OCPUs (1-4 for Always Free)
- [ ] OCI_MEMORY_GB     - Memory in GB (1-24 for Always Free)
- [ ] SSH_KEY_PATH      - Path to SSH public key (default: ~/.ssh/id_rsa.pub)

Deployment Purpose (determines recommended profile):
- [ ] Purpose: coolify / kasm / both / custom
      coolify → 2 OCPU, 12GB RAM (Always Free eligible)
      kasm    → 4 OCPU, 24GB RAM (Always Free eligible)
      both    → 4 OCPU, 24GB RAM (Always Free eligible)

Always Free Tier Limits:
- Shape: VM.Standard.A1.Flex (ARM64)
- Max: 4 OCPUs, 24GB RAM total (can split across instances)

目的別の推奨プロファイル：

すべてのパラメーターを確認するまで、前提条件に進まないでください。

前提条件

このスキルを使用する前に、以下を確認してください。

1. OCI CLI のインストール

oci --version

インストールされていない場合は、次のコマンドでインストールします。

bash -c "$(curl -L https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)" -- --accept-all-defaults
source ~/.bashrc  # or restart terminal

2. OCI CLI の設定

ls ~/.oci/config

設定されていない場合は、次のコマンドで設定します。

oci setup config

必要なもの：

• テナンシー OCID（OCI Console → Profile → Tenancy）
• ユーザー OCID（OCI Console → Profile → My Profile）
• リージョン（例：us-ashburn-1）
• API 鍵ペア（ウィザードで生成されます）

3. SSH 鍵ペア

ls ~/.ssh/id_rsa.pub

ない場合は、次のコマンドで生成します。

ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N ""

4. SSH 鍵の権限

stat -c %a ~/.ssh/id_rsa  # Should be 600

正しくない場合は、次のコマンドで修正します。

chmod 600 ~/.ssh/id_rsa

5. 認証のテスト

oci iam availability-domain list

失敗した場合：API 鍵が OCI Console → Profile → API Keys にアップロードされていない可能性があります。

スクリプトパスの解決：Claude Code がこのファイルを読み込む際、完全なパスが提供されます。以下に記載されているすべての scripts/ 参照先は、このファイルのディレクトリからの相対パスです。このファイルのパスから SKILL_DIR を割り出し、スクリプトの実行時に先頭に付けてください。

クイックスタート

1. まず容量を確認する

OCI Always Free の ARM インスタンスは需要が非常に高いです。デプロイ前に必ず確認してください。

scripts/check-oci-capacity.sh

# Check specific region
scripts/check-oci-capacity.sh us-ashburn-1

# Use different OCI profile
scripts/check-oci-capacity.sh --profile PRODUCTION

# Check multiple regions
for region in us-ashburn-1 us-phoenix-1 ca-toronto-1; do
  echo "=== $region ==="
  scripts/check-oci-capacity.sh "$region"
done

scripts/monitor-and-deploy.sh --stack-id <STACK_OCID>

2. インフラストラクチャをデプロイする

# Configure environment
cp scripts/.env.example scripts/.env
# Edit scripts/.env with your values

# Deploy
scripts/oci-infrastructure-setup.sh

スクリプト一覧

scripts/check-oci-capacity.sh                    # Home region
scripts/check-oci-capacity.sh us-ashburn-1       # Specific region
scripts/check-oci-capacity.sh --profile DANIEL   # With profile

scripts/monitor-and-deploy.sh \
  --stack-id <STACK_OCID> \
  --profile DANIEL \
  --interval 300 \
  --max-attempts 100

scripts/cleanup-compartment.sh ocid1.compartment.oc1..xxx

運用

よくある問題、ベストプラクティス、設定変数、クリーンアップの順序については、references/OPERATIONS.md を参照してください。

ロギングの統合

インフラストラクチャの操作を行う際は、中央のシステムにログを記録してください。

# After provisioning
log_admin "SUCCESS" "operation" "Provisioned OCI instance" "id=$INSTANCE_ID provider=OCI"

# After destroying
log_admin "SUCCESS" "operation" "Terminated OCI instance" "id=$INSTANCE_ID"

# On error
log_admin "ERROR" "operation" "OCI deployment failed" "error=OUT_OF_HOST_CAPACITY"

ロギングに関するドキュメント全体については、admin スキルの references/logging.md を参照してください。

追加ドキュメント

• インストールガイド - あらゆる OS に OCI CLI をインストールします
• 設定ガイド - OCI 認証情報を設定します
• 容量ガイド - 容量の問題への対処方法
• ネットワークガイド - VCN、サブネット、セキュリティリスト
• トラブルシューティングガイド - よくある問題と解決策

公式リソース

• OCI ドキュメント
• OCI CLI リファレンス
• Always Free Tier
• ARM インスタンスガイド