0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

@suzukiyukizi

OCI ハンズオン 事前準備手順書

0
Posted at

～ゼロから前提条件を満たすまでの完全ガイド～

📋 この資料でできるようになること

# やること 所要時間の目安
1 OCIアカウントの作成 約15〜30分
2 管理者権限の確認・設定 約5分
3 OCI CLI のインストールと設定 約15分
4 Java（JDK 11以上）のインストール 約10分
5 Maven のインストール 約10分
6 PowerShell 7 のインストール 約10分
7 OCI PowerShell モジュールのインストール 約5分
8 全項目の動作確認 約5分

💻 対象OS: Windows 11 / macOS 14以降 / Ubuntu 22.04
各手順にはOS別のコマンドを記載しています。

STEP 1：OCIアカウントの作成

1-1. Oracle Cloud の無料アカウントを作成

  1. ブラウザで以下のURLにアクセスします。

    https://www.oracle.com/jp/cloud/free/

  2. 「無料で始める」 ボタンをクリックします。

  3. 以下の情報を入力します。

    入力項目 内容
    国/地域 日本
    名前・姓 ご自身の氏名
    メールアドレス 有効なメールアドレス
    パスワード 12文字以上（大文字・小文字・数字・記号を含む）
    ホームリージョン Japan East (Tokyo) を選択
    テナント名 任意の名前（後から変更不可）

  4. メールアドレスの確認メールが届くので、リンクをクリックして認証します。

  5. クレジットカード情報を登録します（無料枠の確認用で、課金はされません）。

  6. 登録完了後、OCI コンソールにログインできることを確認します。

    https://cloud.oracle.com/

⚠️ ホームリージョンは後から変更できません。 日本で使う場合は Japan East (Tokyo) を選択してください。

1-2. テナントの基本情報を確認・メモする

ログイン後、以降の手順で必要になる情報をメモしておきます。

テナントOCIDの確認

  1. OCIコンソール右上の プロファイルアイコン をクリック
  2. 「テナンシ: <テナント名>」 をクリック
  3. 「テナンシ情報」 タブの 「OCID」 をコピーしてメモ

ユーザーOCIDの確認

  1. OCIコンソール右上の プロファイルアイコン をクリック
  2. 「マイ・プロファイル」 をクリック
  3. 「ユーザー情報」 タブの 「OCID」 をコピーしてメモ

ホームリージョンの確認

  1. OCIコンソール右上のリージョン名（例: 東日本）を確認
  2. リージョン識別子（例: ap-tokyo-1）をメモ
メモ欄：
テナントOCID  : ocid1.tenancy.oc1..xxxxxxxxxx
ユーザーOCID  : ocid1.user.oc1..xxxxxxxxxx
ホームリージョン: ap-tokyo-1

STEP 2：管理者権限の確認・設定

2-1. 自分が管理者グループに所属しているか確認

  1. OCIコンソールの左上メニュー → 「アイデンティティとセキュリティ」 → 「ドメイン」 をクリック
  2. 「Default」 ドメインをクリック
  3. 左メニューの 「グループ」 をクリック
  4. 「Administrators」 グループをクリック
  5. 「メンバー」 タブで自分のユーザーが表示されているか確認

2-2. 管理者グループに追加されていない場合

既にAdministratorsグループに所属している場合はSTEP 3へ進みます。

テナント管理者に依頼するか、自分がテナントの初期管理者であれば以下の手順を実施します。

  1. 「アイデンティティとセキュリティ」 → 「ドメイン」 → 「Default」 → 「グループ」
  2. 「Administrators」 をクリック → 「メンバーの追加」
  3. 自分のユーザーを選択して追加

STEP 3：OCI CLI のインストールと設定

3-1. OCI CLI のインストール

Windows の場合

PowerShell を 管理者として起動 して以下を実行します。

# インストーラーのダウンロードと実行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-WebRequest -Uri https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.ps1 -OutFile install.ps1
./install.ps1 --accept-all-defaults

インストール完了後、PowerShellを 再起動 してから確認します。

oci --version

macOS の場合

# Homebrew を使ったインストール（推奨）
brew install oci-cli

# バージョン確認
oci --version

Homebrew がインストールされていない場合は先に以下を実行します。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Linux (Ubuntu) の場合

# インストールスクリプトのダウンロードと実行
bash -c "$(curl -fsSL https://raw.githubusercontent.com/oracle/oci-cli/master/scripts/install/install.sh)"

# プロンプトが表示されたらすべてデフォルト（Enter）で進める
# インストール後、シェルを再起動
source ~/.bashrc

# バージョン確認
oci --version

✅ 確認コマンド

oci --version
# 出力例: 3.43.0

3-2. OCI CLI の設定（oci setup config）

OCI CLIがOCIテナントに接続するための認証情報を設定します。

oci setup config

対話形式で以下の情報を入力します。

Enter a location for your config [/home/youruser/.oci/config]: （Enterでデフォルト）

Enter a user OCID: ocid1.user.oc1..xxxxxxxxxx         ← STEP 1-2でメモしたユーザーOCID
Enter a tenancy OCID: ocid1.tenancy.oc1..xxxxxxxxxx   ← STEP 1-2でメモしたテナントOCID
Enter a region by index or name: ap-tokyo-1            ← ホームリージョン

Do you want to generate a new API Signing RSA key pair? [Y/n]: Y  ← Yを入力
Enter a directory for your keys to be created [/home/youruser/.oci]: （Enterでデフォルト）
Enter a name for your key [oci_api_key]: （Enterでデフォルト）
Enter a passphrase for your private key (empty for no passphrase): （Enterで空白推奨）

3-3. 公開鍵をOCIコンソールに登録

oci setup config で生成された 公開鍵 をOCIに登録します。

公開鍵の内容を確認

# Windows
type %USERPROFILE%\.oci\oci_api_key_public.pem

# macOS / Linux
cat ~/.oci/oci_api_key_public.pem

出力される -----BEGIN PUBLIC KEY----- から -----END PUBLIC KEY----- までの内容をすべてコピーします。

OCIコンソールで登録

  1. OCIコンソール右上の プロファイルアイコン → 「マイ・プロファイル」
  2. 左下の 「APIキー」 をクリック
  3. 「APIキーの追加」 をクリック
  4. 「公開キーの貼り付け」 を選択し、コピーした公開鍵を貼り付け
  5. 「追加」 をクリック

登録後に表示される 「フィンガープリント」 （例: xx:xx:xx:...）をメモします。

3-4. OCI CLI の接続確認

# テナント情報が取得できるか確認
oci iam region list

# 正常な出力例（リージョン一覧が表示されればOK）
# {
#   "data": [
#     { "key": "NRT", "name": "ap-tokyo-1" },
#     ...
#   ]
# }

エラーが出る場合は、フィンガープリントや設定ファイルのパスを確認してください。

# 設定ファイルの内容を確認
cat ~/.oci/config  # macOS/Linux
type %USERPROFILE%\.oci\config  # Windows

STEP 4：Java（JDK 11以上）のインストール

4-1. JDKのインストール

Windows の場合

  1. 以下のURLからMicrosoft Build of OpenJDK をダウンロードします。

    https://learn.microsoft.com/ja-jp/java/openjdk/download

  2. JDK 17 の Windows x64 MSI をダウンロードしてインストーラーを実行します。

  3. インストール時に 「Add to PATH」 にチェックを入れてください。

または、winget（Windows パッケージマネージャー）を使う場合：

winget install Microsoft.OpenJDK.17

macOS の場合

# Homebrew でインストール
brew install openjdk@17

# パスを通す
echo 'export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Ubuntu) の場合

sudo apt update
sudo apt install -y openjdk-17-jdk

4-2. インストール確認

java -version

# 期待される出力例
openjdk version "17.0.x" 202x-xx-xx
OpenJDK Runtime Environment ...
OpenJDK 64-Bit Server VM ...

4-3. JAVA_HOME 環境変数の設定

Windows の場合

# システム環境変数に設定（管理者PowerShellで実行）
[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Microsoft\jdk-17.0.x.x-hotspot", "Machine")

macOS / Linux の場合

# macOS
echo 'export JAVA_HOME=$(/usr/libexec/java_home -v 17)' >> ~/.zshrc
source ~/.zshrc

# Linux
echo 'export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64' >> ~/.bashrc
source ~/.bashrc

確認

echo $JAVA_HOME   # macOS/Linux
echo %JAVA_HOME%  # Windows (コマンドプロンプト)

STEP 5：Maven のインストール

5-1. Maven のインストール

Windows の場合

# winget でインストール
winget install Apache.Maven

または手動インストール：

  1. 以下からバイナリ zip をダウンロードします。

    https://maven.apache.org/download.cgi

  2. C:\Program Files\Maven\ に展開します。

  3. システム環境変数 PATH に C:\Program Files\Maven\bin を追加します。

macOS の場合

brew install maven

Linux (Ubuntu) の場合

sudo apt install -y maven

5-2. インストール確認

mvn -version

# 期待される出力例
Apache Maven 3.9.x (...)
Maven home: /usr/share/maven
Java version: 17.0.x, vendor: ...

⚠️ Java version が 11以上 であることを確認してください。

STEP 6：PowerShell 7 のインストール

6-1. PowerShell 7 のインストール

Windows の場合

Windows には PowerShell 5.1 が標準搭載されていますが、PowerShell 7（pwsh） は別途インストールが必要です。

# winget でインストール（PowerShell 5.1のウィンドウで実行）
winget install Microsoft.PowerShell

または Microsoft Store から 「PowerShell」 を検索してインストールします。

インストール後は、スタートメニューから 「PowerShell 7」 を起動します（pwsh コマンドでも起動できます）。

macOS の場合

brew install --cask powershell

Linux (Ubuntu) の場合

# Microsoft GPGキーとリポジトリを登録
sudo apt update
sudo apt install -y wget apt-transport-https software-properties-common
wget -q "https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb"
sudo dpkg -i packages-microsoft-prod.deb
sudo apt update
sudo apt install -y powershell

6-2. インストール確認

pwsh --version

# 期待される出力例
PowerShell 7.4.x

⚠️ powershell コマンド（5.1）ではなく pwsh（7以上） で実行することを確認してください。

STEP 7：OCI PowerShell モジュールのインストール

PowerShell 7（pwsh）を起動してから以下を実行します。

7-1. PowerShell Gallery の接続確認

# まずPowerShell 7を起動
pwsh

# NuGetプロバイダーのインストール（初回のみ）
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force

7-2. OCI PowerShell モジュールのインストール

# OCI全モジュールのインストール（推奨・約10〜20分かかります）
Install-Module OCI.PSModules -Force -AllowClobber -Scope CurrentUser

# インストール確認
Get-Module -ListAvailable OCI* | Select-Object Name, Version

時間を節約したい場合は、ハンズオンで使用するモジュールのみインストールします。

# 必要なモジュールのみ（軽量版）
Install-Module OCI.PSModules.Vault    -Force -Scope CurrentUser
Install-Module OCI.PSModules.Secrets  -Force -Scope CurrentUser
Install-Module OCI.PSModules.Identity -Force -Scope CurrentUser

7-3. OCI PowerShell の接続確認

# モジュールのインポート
Import-Module OCI.PSModules.Identity

# リージョン一覧を取得して接続確認（OCI CLIの設定を自動的に参照します）
Get-OCIIdentityRegions

# 期待される出力例（リージョン一覧が表示されればOK）
Key    Name
---    ----
NRT    ap-tokyo-1
IAD    us-ashburn-1
...

STEP 8：全項目の動作確認

すべての前提条件が整ったか、以下のチェックリストで確認します。

確認スクリプト（まとめて実行）

bash / zsh（macOS・Linux・Windows WSL）

echo "=== 前提条件 確認レポート ==="
echo ""

echo "【1】OCI CLI"
oci --version 2>/dev/null && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【2】OCI CLI 接続テスト"
oci iam region list > /dev/null 2>&1 && echo "✅ OK（OCIへの接続成功）" || echo "❌ 接続失敗（oci setup config を再確認してください）"
echo ""

echo "【3】Java"
java -version 2>&1 | head -1 && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【4】Maven"
mvn -version 2>&1 | head -1 && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【5】PowerShell 7"
pwsh --version 2>/dev/null && echo "✅ OK" || echo "❌ 未インストール"
echo ""

echo "【6】OCI PowerShell モジュール"
pwsh -c "Get-Module -ListAvailable OCI.PSModules.Secrets | Select-Object Name,Version" 2>/dev/null && echo "✅ OK" || echo "❌ 未インストール"

PowerShell（Windows）

Write-Host "=== 前提条件 確認レポート ===" -ForegroundColor Cyan
Write-Host ""

# OCI CLI
Write-Host "【1】OCI CLI" -ForegroundColor Yellow
$ociVersion = oci --version 2>&1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $ociVersion" -ForegroundColor Green }
else { Write-Host "❌ 未インストール" -ForegroundColor Red }
Write-Host ""

# OCI CLI 接続テスト
Write-Host "【2】OCI CLI 接続テスト" -ForegroundColor Yellow
$regions = oci iam region list 2>&1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK（OCIへの接続成功）" -ForegroundColor Green }
else { Write-Host "❌ 接続失敗（oci setup config を再確認してください）" -ForegroundColor Red }
Write-Host ""

# Java
Write-Host "【3】Java" -ForegroundColor Yellow
$javaVersion = java -version 2>&1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $($javaVersion[0])" -ForegroundColor Green }
else { Write-Host "❌ 未インストール" -ForegroundColor Red }
Write-Host ""

# Maven
Write-Host "【4】Maven" -ForegroundColor Yellow
$mvnVersion = mvn -version 2>&1
if ($LASTEXITCODE -eq 0) { Write-Host "✅ OK: $($mvnVersion[0])" -ForegroundColor Green }
else { Write-Host "❌ 未インストール" -ForegroundColor Red }
Write-Host ""

# PowerShell 7
Write-Host "【5】PowerShell 7" -ForegroundColor Yellow
$pshVersion = $PSVersionTable.PSVersion
if ($pshVersion.Major -ge 7) { Write-Host "✅ OK: PowerShell $pshVersion" -ForegroundColor Green }
else { Write-Host "⚠️ PowerShell $pshVersion（バージョン7以上が必要です）" -ForegroundColor Yellow }
Write-Host ""

# OCI PowerShell モジュール
Write-Host "【6】OCI PowerShell モジュール" -ForegroundColor Yellow
$ociModule = Get-Module -ListAvailable OCI.PSModules.Secrets
if ($ociModule) { Write-Host "✅ OK: $($ociModule.Name) $($ociModule.Version)" -ForegroundColor Green }
else { Write-Host "❌ 未インストール（Install-Module OCI.PSModules を実行してください）" -ForegroundColor Red }

✅ 全項目OKの場合の出力例

=== 前提条件 確認レポート ===

【1】OCI CLI
✅ OK: 3.43.0

【2】OCI CLI 接続テスト
✅ OK（OCIへの接続成功）

【3】Java
✅ OK: openjdk version "17.0.11" 2024-04-16

【4】Maven
✅ OK: Apache Maven 3.9.6

【5】PowerShell 7
✅ OK: PowerShell 7.4.2

【6】OCI PowerShell モジュール
✅ OK: OCI.PSModules.Secrets 88.1.0

🛠️ よくあるトラブルと対処法

OCI CLI の接続確認でエラーが出る

ServiceError: 401, NotAuthenticated

対処法： APIキーの登録が正しく完了しているか確認します。

  1. ~/.oci/config の fingerprint の値が、OCIコンソールのAPIキーに表示されているフィンガープリントと一致しているか確認
  2. 一致していない場合は oci setup config を再実行

Java インストール後に java: command not found が出る

対処法： PATHが通っていないため、ターミナルを再起動してから再確認します。
それでも解決しない場合は、以下を実行します。

# パスを手動で確認
which java        # macOS/Linux
where java        # Windows

PowerShell モジュールのインストールが遅い・タイムアウトする

対処法： 全モジュールは非常に大きいため、必要なモジュールのみ個別にインストールします。

Install-Module OCI.PSModules.Secrets  -Force -Scope CurrentUser
Install-Module OCI.PSModules.Vault    -Force -Scope CurrentUser

Windows で pwsh コマンドが見つからない

対処法： PowerShell 5.1（powershellコマンド）でインストールが完了している場合でも、パスが通っていないことがあります。

# PowerShell 7 のインストール先を確認
where.exe pwsh

# 通常は以下のパスにインストールされます
# C:\Program Files\PowerShell\7\pwsh.exe

✅ 前提条件チェックリスト

すべてに✅がついたら、ハンズオン本編に進めます。

  • OCIアカウントが作成済みで、コンソールにログインできる
  • Administratorsグループに所属している（または同等の権限がある）
  • oci --version でバージョンが表示される
  • oci iam region list でリージョン一覧が取得できる
  • java -version でバージョン11以上が表示される
  • mvn -version でバージョンが表示される
  • pwsh --version でバージョン7以上が表示される
  • Get-Module -ListAvailable OCI.PSModules.Secrets でモジュールが表示される
0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?