ノードを受け取りましたか？まずデスクトップに接続してパスワードを変更し、ビルドや推論のタスクを実行しましょう。まだ注文していない場合は、必要な操作を確認してからプランをお選びいただけます。
キーワードでこのページの手順を絞り込めます。検索せずにそのまま読むこともできます。
接続先と認証情報は、ログイン後にインスタンス詳細でご確認ください。このページでは認証情報の表示やリモート操作は行いません。
ツール名や「SSH」「画面が真っ暗」「ディスク」など短い症状で検索してみてください。検索をクリアしてすべての内容を表示することもできます。また、コンソールからサポートチケットを送る際に、エラー全文を添付してください。
以下の順に進めてください。最初にインスタンスと接続情報を確認し、その後でツールチェーンを設定します。接続の問題とビルドの問題は分けて調べましょう。
注文時に使用したメールアドレスでコンソールにログインし、画面の案内に従ってログインまたはアカウント登録を行います。インスタンス一覧で、注文に対応するモデル、ノード、課金期間を確認してください。
支払いが完了しても、システムがすぐに使えるとは限りません。まずインスタンスの準備状況を確認し、インスタンス詳細に接続情報が表示されてから接続してください。注文が見つからない場合は、現在のメールアドレスが注文時のものと一致しているか確認しましょう。
ログインしてインスタンスを確認準備完了したインスタンスの詳細で、接続先アドレス、ユーザー名、パスワード、ポートを確認します。VNCとSSHにはそれぞれ画面に表示された情報を使用してください。両方の接続で同じポートが使われるとは限りません。
SSHで初めて接続するときは、ホスト情報を確認してからフィンガープリントを信頼してください。パスワードや秘密鍵、認証情報が写ったスクリーンショットを公開リポジトリ、チャットグループ、ビルドログに載せないでください。
プラットフォーム別の接続手順を見るまず現在のパスとバージョンを確認し、必要に応じてインストールしてください。プロジェクトでフル版のXcodeが必要な場合、コマンドラインツールだけでは不十分です。SDK、シミュレータ、ビルドツールのバージョンをプロジェクトの要件に合わせましょう。
xcode-select -p
xcodebuild -version
xcrun --find clang組織で承認されたインストーラを使ってXcodeをインストールまたは切り替えます。初回起動後にコンポーネントの初期化を完了し、ターミナルでバージョンを再確認してください。開発者ディレクトリの切り替えには管理者権限が必要な場合があります。
確認項目：パス、バージョン、コンパイラmacOSのユーザー設定で現在のユーザーのパスワードを変更するか、ターミナルで passwd を実行し、表示される案内に従って変更します。専用の強力なパスワードを設定し、コードホスティングやメールと使い回さないでください。
変更後は現在のセッションを開いたままにし、別の接続で新しいパスワードを確認してください。SSHを公開鍵認証に切り替える場合も、新しいセッションでログインできることを確認しましょう。復旧手段がない状態で、現在の認証方法を無効にしないでください。
新しい接続を確認してから、古いセッションを終了runnerの登録、実行ユーザーの確認、ツールチェーンの検証を済ませてから並列数を調整します。以下の作業はご自身のノードで行い、パイプラインの権限はコードホスティングプラットフォームで管理してください。
リポジトリまたは組織のActions設定でself-hosted runnerを追加し、macOSとARM64を選択します。ダウンロードと登録のコマンドは、そのページで生成されたものを使用し、登録トークンを長期利用するスクリプトに含めないでください。
ビルドを実行するmacOSユーザーで登録します。そのユーザーがプロジェクトのディレクトリを読み取れ、ビルドに必要なキーチェーンにアクセスできることを確認してください。
たとえば、ノードに osxflow-m4 ラベルを設定し、まずテスト用ワークフロー1つだけをそのラベルに割り当てます。古いrunnerが同じタスクを取得しないようにしてください。
まず対話形式で起動してワークフローが成功することを確認し、その後runnerに付属するサービスの手順に従って常駐設定を行います。再ログイン後、プロセスとプラットフォーム側の接続状態を確認してください。
jobs:
verify:
runs-on: [self-hosted, macOS, ARM64, osxflow-m4]
steps:
- run: |
uname -m
xcodebuild -version
xcrun --find clang信頼できない外部からのコミットに、署名用の認証情報を持つrunnerを直接使わせないでください。テスト用パイプラインが成功してから、リリースフローとシークレット変数を移行しましょう。
プロジェクトまたはグループの設定で作成したrunner認証情報を使って登録し、executorに shellを選びます。タスクはノード上のユーザー環境で直接実行され、コンテナレベルの分離はありません。
まず並列実行数を1に制限し、複数の署名タスクやキャッシュ書き込みが干渉しないようにします。runnerユーザーの PATH、開発者ディレクトリ、Ruby環境が手動テスト時と一致していることを確認してください。
concurrent = 1
[[runners]]
executor = "shell"
shell = "bash"これは登録後の設定ファイルにある関連項目であり、登録設定全体ではありません。登録ツールが生成した接続先、認証情報、その他の項目は残し、この内容でファイル全体を上書きしないでください。
runnerに専用ラベルを設定し、テストタスクで whoami、pwd と xcode-select -pを出力させます。ターミナルではビルドできるのにCIで失敗する場合は、ツールを再インストールするのではなく、ユーザー、パス、環境変数を優先して比較してください。
証明書、秘密鍵、プロビジョニングプロファイルは、チームの承認手順に従ってインポートしてください。ソースコードリポジトリに置かず、Fastlaneの出力に復号用パスフレーズを表示しないでください。
専有物理マシンを利用しても、プロジェクトの権限管理は必要です。リリースパイプラインを変更できる人は、タスクを通じて署名環境を読み取れる可能性があります。リポジトリの権限もあわせて確認してください。
上位モデルの構成はM4 Pro / 64GB / 2TBです。ユニファイドメモリはシステムとタスクで共有されるため、64GBすべてをモデルに割り当てられるわけではありません。モデルの重み、コンテキスト、実行時キャッシュに必要な容量を見込んでください。
まずPythonがARM64で動作していることを確認し、実験ごとに仮想環境を作成してください。異なるモデルプロジェクトの依存関係をシステム環境に混在させないでください。
python3 -c "import platform; print(platform.machine())"
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install mlx-lm
python -m pip freeze > requirements.lock.txt依存関係一覧、Pythonのバージョン、モデルのバージョンを保存します。実験を再現するときは、同じ環境を用意してから出力とリソース使用量を比較してください。
目標：独立した環境、再現可能な依存関係使用許可のあるMLX対応量子化モデルを選び、まずモデルの説明を確認してください。量子化ビット数、コンテキスト長、生成長を記録し、モデルファイルのサイズだけで比較しないようにしましょう。
python -m mlx_lm.generate --helpインストール済みバージョンのヘルプに従って、モデルとプロンプトを指定します。まず1回推論を実行し、その後コンテキストを段階的に増やしてください。アクティビティモニタでメモリプレッシャーとスワップ領域を確認し、負荷が上がり続ける場合はタスクを小さくします。
実験を比較するときは、プロンプト、生成長、並列数を固定してください。モデルや量子化方式が異なる場合、その結果をノード性能の差として直接比較することはできません。
スループットを保証せず、モデルが必ず収まるとも約束しません容量を追加する場合は、注文時に+2TB SSDを選択できます。ノード上で実際のマウント先と空き容量を確認してから、モデルの重みとダウンロードキャッシュを移してください。すべてのノードで同じボリューム名が使われるとは限りません。
移行前に、モデルを読み込んでいるタスクを停止します。コピー後にファイル数とサイズを確認し、ツールのモデルパスまたはキャッシュ設定を変更してください。読み込みに成功したことを確認してから、元のコピーを削除します。
ストレージを増やしてもバックアップにはなりません。モデルのバージョン、設定、重要な結果は、ご自身で管理できる場所にも保存し、レンタル中のノードだけに置かないようにしてください。
ストレージの追加と料金を見る注文、接続、サポートチケットでは、以下の定義を共通して使用します。同じ用語で状況を説明すると、マシン、接続プロトコル、課金設定をすばやく区別できます。
設定を変更する前に、エラー全文を記録してください。接続済みのセッションを1つ残し、唯一のアクセス手段をテストのために無効にしないでください。
まずインスタンス詳細でシステムの準備が完了していることを確認し、VNCのアドレスとポートを確認してください。接続を切ってクライアントを1つだけにして再試行し、解像度を下げるか画質の自動調整を無効にして、クライアントの表示問題かノードのセッション問題かを切り分けます。
SSHで接続できる場合は、タスクを実行中のノードをすぐに再起動しないでください。クライアント名とバージョン、画面が真っ暗になる前の操作、SSHの接続可否を記録します。チケットには認証情報を含まないスクリーンショットを添付してください。
各プラットフォームのデスクトップ接続方法を見るConnection refused アドレス、ポート、サービスの状態を確認してください。接続がタイムアウトする場合は、まずローカルネットワーク、プロキシ、アクセス制限を確認します。Permission denied の場合はユーザー名と認証方式を優先して確認し、認証の失敗をネットワーク障害と混同しないでください。
接続状況の調査には ssh -v を使えます。デバッグログ全体を公開しないでください。共有前にアドレス、ユーザー名、鍵のパス、認証に関する情報を伏せてください。秘密鍵を使う場合は、ファイルの権限とサーバー側の公開鍵が対応しているか確認します。
GUIデスクトップに接続できる場合は、まずシステム設定でリモートログインの状態を確認してください。判断できない場合は、エラー全文、ノード番号、使用ポートを添えてサポートチケットを送り、認証設定を一度に複数変更しないでください。
まずダウンロード、検証、展開のどの段階かを確認します。ネットワーク通信量、CPU、ディスクの動作を見てください。ネットワークが一時的に止まっていても、ディスクが動作中ならダウンロードが中断したとは限りません。同じインストールを複数回開始しないでください。
インストーラ、展開後のファイル、プロジェクトのキャッシュをすべて保存できる空き容量が対象ディスクにあるか確認してください。バージョンを固定する場合は、組織で承認されたインストーラを使用し、完全性を検証します。インストール後に xcodebuild -versionを再実行し、CIとGUIで同じバージョンが使われていることを確認してください。
チケットにはXcodeのバージョン、現在の処理段階、空き容量、プロキシ経由で接続しているかを記載し、「遅い」だけで済ませないようにしましょう。
まずボリュームの容量を確認し、次に大きなディレクトリを探します。以下のコマンドは容量を表示するだけで、ファイルは削除しません。大きなユーザーディレクトリの集計には時間がかかる場合があります。
df -h
du -sh "$HOME/Library/Developer/Xcode/DerivedData"
du -sh "$HOME/Library/Caches"ビルドを一時停止してから、再生成できるキャッシュを整理してください。キーチェーン、署名情報、プロジェクトのソースファイル、唯一のモデルコピーをディレクトリごと削除しないでください。キャッシュを消すと初回ビルドで再生成が必要になるため、その時間もリリース計画に含めましょう。
増え続けるモデルの重みやビルド成果物には、別途容量を確保するのがおすすめです。+1TB SSDまたは+2TB SSDを追加できます。既存の注文を変更する場合は、コンソールからチケットを送り、手順を確認してください。追加後にプロジェクトが自動で移行されるとは限りません。
SSDオプションを見るこのページでは「次に何をすればよいか」を説明しています。ビルドの実践、マシンの選び方、データ保護についての詳しい解説は、技術記事一覧をご覧ください。記事のタイトル、概要、公開日は一覧に掲載された最新情報をご確認ください。
ご利用中のお客様は、インスタンスと紐付けて管理できるよう、コンソールにログインしてチケットを送信してください。パスワード、秘密鍵、カード番号全体、認証情報が写ったスクリーンショットは送らないでください。
ノード番号、注文番号、問題が発生したおおよその日時とタイムゾーンを記載してください。支払いに関する場合は取引の識別情報のみを伝え、認証情報は含めないでください。
何を実行したか、期待した結果、実際に起きたことを記載してください。接続の問題にはクライアント名とバージョンを、ビルドの問題にはツールチェーンのバージョンを添えてください。
機密情報を伏せたエラー全文を貼り、GUIデスクトップとSSHのどちらが使えるか、中断できない実行中のタスクがあるかを記載してください。
コンソールからインスタンスに紐付けたチケットを送信できます。購入前の相談、メールでの問い合わせ、請求に関する質問は、まずお問い合わせ案内をご確認ください。