概念だけのドキュメントではありません。各ガイドで準備項目、実行手順、確認結果、失敗時に保存すべきログを説明します。SSH、VNCリモートデスクトップ、Xcode、fastlane、セルフホストRunner、請求管理に対応しています。
現在対応中のタスクを選ぶか、SSH、アーカイブ、署名、Runner、ノード、請求などのキーワードを入力してください。絞り込みは一覧カードだけを変更し、完全な手順はこのページ下部に残ります。
9件のガイドを表示
公開鍵を準備し、ホストフィンガープリントとarm64環境を確認して、グラフィカルセッション終了後に安全に切断します。
目安10分 開発環境を設定ツールチェーンのバージョンを固定し、コマンドラインのパスを確認して、ロックファイルに従ってRuby、Pods、Swift Packageの依存関係を復元します。
目安15分 ビルドを実行workspace、scheme、destinationを明示してアーカイブを実行し、xcresultと書き出しログを保存します。
目安20分 ビルドを実行機密変数を一時的に注入し、固定したlaneを実行します。成果物を保存したら一時ファイルとプロセス環境を削除します。
目安20分 ビルドを実行専用Runnerを登録し、リポジトリの範囲を制限して能力タグを設定します。各タスク後に作業ディレクトリをクリーンアップします。
目安25分 開発環境を設定ネットワーク、ディスク、署名素材、依存キャッシュ、同時実行を順に確認し、複数の変数を同時に変更しないようにします。
目安15分 デバイスに接続開発者、コードリポジトリ、パイプラインサービスの場所に応じて5つのノードから1つを選び、チケットで移行を申請します。
目安5分 請求を管理注文ID、レンタル期間、ノード、ストレージまたはThunderbolt 5並列接続項目を提出すると、請求記録を特定しやすくなります。
4項目を準備 請求を管理コンソールのチケットまたはサポートメールで、デバイスID、ノード、時間範囲、マスキング済みログを送信します。
2つの連絡手段キーワードを短くするか、「すべてのガイド」に切り替えてページの各章を確認してください。
接続情報はコンソールの表示を基準にしてください。秘密鍵、一時認証情報、完全な接続コマンドを公開リポジトリ、ビルドログ、チームチャットに貼り付けないでください。
パスフレーズで保護した専用鍵を優先してください。公開鍵だけをアップロードし、チケットやメールで秘密鍵の内容を送信しないでください。
コンソールでデバイスID、ノード、ホストアドレス、ポート、ユーザー名を確認し、以前のレンタル記録を再利用しないでください。
初回接続前にコンソールのフィンガープリントと比較してください。一致しない場合は接続を停止してチケットを送信し、ローカル記録を直接上書きしないでください。
実行 uname -m、xcodebuild -version と df -h /を実行し、アーキテクチャ、ツールチェーン、ディスク空き容量を記録します。
グラフィカル接続に失敗した場合、SSHはプロセス、ディスク、ネットワーク状態を確認する主要な経路です。先にホストフィンガープリントを検証してください。
現在のデバイスに対応するVNCエンドポイントと一時認証情報を使用し、ブラウザー同期、共有ドキュメント、パイプライン変数には保存しないでください。
ログイン後、解像度、キーボードレイアウト、Xcodeの起動状態、空き容量を確認してから署名またはアーカイブを開始します。
実行中の開発ツールを終了し、一時ダウンロードと平文の認証情報を削除してからリモートデスクトップセッションを閉じます。
グラフィカルインターフェースで前回選択したschemeに依存しないでください。自動化タスクではXcodeのパス、workspace、scheme、configuration、destination、書き出し設定を明示します。
プロジェクト要件を確認してから xcode-select で対象バージョンを指定します。続けて xcodebuild -version と xcrun swift --versionをそれぞれ実行し、出力をビルドログの先頭に記録します。
Rubyプロジェクトではまず bundle installを実行し、Podsプロジェクトはロックファイルから復元し、Swift Packageは先に依存関係を解決します。キャッシュは高速化のためだけに使い、ロックファイルのバージョン制約の代わりにしないでください。
DerivedDataとarchivePathを現在のタスク専用ディレクトリに指定します。同時実行タスクで出力パスを共有すると、インデックス、キャッシュ、アーカイブが上書きされるおそれがあります。
バージョン管理された書き出し設定で実行します。コマンドの終了コード、成果物、署名結果、dSYMを確認してから、管理された納品ディレクトリへコピーします。
少なくともプレーンテキストのビルド出力、書き出しログ、xcresultを保存します。ファイル名にはパイプラインタスクIDを含め、アクセストークン、秘密鍵、完全な署名素材は含めないでください。
xcode-select -p
xcodebuild -version
xcrun swift --version
bundle install
bundle exec pod install
xcodebuild archive \
-workspace App.xcworkspace \
-scheme App \
-configuration Release \
-destination "generic/platform=iOS" \
-archivePath output/App.xcarchive \
-resultBundlePath output/App.xcresult
xcodebuild -exportArchive \
-archivePath output/App.xcarchive \
-exportPath output/export \
-exportOptionsPlist ExportOptions.plistfastlaneはビルド手順をまとめるためのもので、鍵を長期保存するものではありません。署名素材、リポジトリトークン、アップロード認証情報は管理対象変数から注入し、タスク終了後に削除します。
タスク開始時に必要最小限の変数を注入します。一時ファイルはタスク専用ディレクトリに置き、権限を制限し、コマンドのエコーで変数値を出力しないでください。
Rubyとgemのバージョンを固定するため、 bundle exec fastlane を使用します。lane内でscheme、書き出し方式、出力ディレクトリ、失敗時の終了条件を明示してください。
まずアーカイブ、書き出しファイル、ログを管理された場所にコピーし、その後、一時署名ファイル、環境ファイル、ダウンロードキャッシュ、タスク作業ディレクトリを削除します。
bundle exec fastlane ios archive
依存関係のバージョンを固定
独立した出力ディレクトリ
失敗時はゼロ以外の終了コードを返す
Runnerには明確なリポジトリまたはプロジェクト範囲を設定します。信頼できないブランチのタスクに本番用署名素材を自動付与せず、セキュリティレベルの異なるタスクで同じ作業ディレクトリを共有しないでください。
チームの権限モデルに応じてリポジトリ単位または組織単位のRunnerを選び、呼び出せるプロジェクトを制限します。
Runnerプロセスに日常の管理者アカウントを使わないでください。作業ディレクトリとビルドツールに必要な権限だけを付与します。
タグにはアーキテクチャ、Xcodeメジャーバージョン、タスク種別を示し、ワークフローが適切なノードを選べるようにします。
1つの作業ディレクトリでは同時に1タスクだけ処理します。並列実行には専用ディレクトリまたは専用デバイスを使用します。
一時変数ファイル、署名素材、未アップロード成果物を削除し、残留プロセスを確認してから次のタスクを受け付けます。
パイプラインからクラウドMacへタスクを割り当て、デバイス管理認証情報をリポジトリ設定に記述しないでください。
ビルドユーザーは指定されたリポジトリ、キャッシュ、出力パスだけにアクセスし、管理操作には別の権限経路を使います。
本番ビルド前にアーキテクチャ、Xcode、Ruby、依存関係マネージャー、ディスク空き容量を確認し、失敗したらタスクを停止します。
依存関係のインストール、テスト、アーカイブ、書き出しのいずれかが失敗した場合はゼロ以外のステータスを返し、パイプラインが成功と誤認しないようにします。
成果物とログのアップロードを確認してからタスクディレクトリを削除します。チケットと関連付けられるようタスクIDを残します。
まず失敗したタスクIDと時間範囲を記録し、ネットワーク、ディスク、署名、キャッシュ、同時実行の順に確認します。各手順の結果を保存し、環境の再インストールを繰り返さないようにします。
まずローカルネットワークからデバイスのポートに到達できることを確認し、DNS、プロキシ、SSHホストフィンガープリント、システム時刻を確認します。接続開始時刻、切断時刻、エラー原文を個別に記録してください。SSHは使えるのにVNCが使えない場合はグラフィカルセッションのプロセスを確認し、開発環境全体を先にリセットしないでください。
ssh -v user@host
次を使用して df -h / ボリュームの空き容量を確認し、DerivedData、依存キャッシュ、古いarchive、シミュレータデータを調べます。まず大きなディレクトリを特定し、明確に再生成できるキャッシュだけを削除してください。ビルド実行中に使用中のディレクトリを削除しないでください。
du -sh ~/Library/Developer/*
プロジェクトID、ビルド設定、書き出し方式、証明書の有効性、プロビジョニングプロファイルの対応を確認します。パイプラインが現在のタスクに必要な素材を注入していることと、システム時刻を確認してください。ログ提出時はエラー種別と照合手順を残し、証明書の内容、秘密鍵、トークンは隠してください。
security find-identity -v -p codesigning
まずロックファイルとログに記録された実際のバージョンを比較します。共有キャッシュなしの新しいタスクディレクトリでビルドし、問題が解消したらSwift Package、Pods、Ruby、DerivedDataのキャッシュを段階的に戻して汚染元を特定します。
swift package resolve
同時実行中のxcodebuild、テスト、依存関係プロセスと、各タスクの出力ディレクトリを確認します。同時実行数を下げて再テストし、ピークメモリ、ディスク書き込み、所要時間を観察します。複数タスクでarchivePath、resultBundlePath、一時署名ディレクトリを共有しないでください。
ps -axo pid,%cpu,%mem,command
シンガポール、日本（東京）、韓国（ソウル）、香港、米国東部で365日安定稼働。カタログ上の組み合わせは通常注文できますが、実際の可用性はコンソールのリアルタイム表示を基準にしてください。
| ノード | 優先検討に適したチームの所在地 | MiniRents M4 | MiniRents M4 Pro | 選択の目安 |
|---|---|---|---|---|
| シンガポールSG | 東南アジアのチームと近隣のコードリポジトリ | 十分 | 十分 | 開発者からノード、リポジトリからノードへの接続安定性を優先して比較してください。 |
| 日本（東京）JP | 日本と東アジアのチーム | 十分 | 十分 | コードリポジトリと協業メンバーが主に東アジアにあるワークフローに適しています。 |
| 韓国（ソウル）KR | 韓国と近隣の東アジアチーム | 十分 | 十分 | 選択前に実際のオフィスネットワークからSSHの安定性をテストできます。 |
| 香港HK | 中国南部と東南アジアの協業チーム | 十分 | 十分 | 複数のアジア拠点と連携するチームの比較検討に適しています。 |
| 米国東部US-E | 北米東部と西ヨーロッパのチーム | 十分 | 十分 | リポジトリ、成果物サービス、主要メンバーが北米東部に近いワークフローに適しています。 |
VNCを頻繁に使う場合は開発者からノードへの安定性を優先し、パイプラインだけで自動実行する場合はリポジトリと成果物サービスの場所を重視します。
依存関係のダウンロード、リポジトリの取得、成果物のアップロードはいずれも回線を使用します。主なデータソースと実行ノードを、接続がより安定した経路上に配置してください。
現在のデバイスID、現ノード、移行先ノード、希望時間帯、移行理由を提出します。対応結果と以降の手順はコンソールのチケット記録を基準にしてください。
技術的な問題には、デバイスと注文を関連付けられるコンソールのチケットを優先してください。コンソールにログインできない場合や、導入前、請求、セキュリティ、チーム展開について相談する場合はメールを利用できます。
接続切断、デバイス状態、ビルド環境、ノード移行、注文、請求の問題に適しています。チケットには現在のデバイスまたは注文を関連付け、再現に必要な情報を記載してください。
コンソールにログインできない場合、導入前の構成評価、チーム展開、セキュリティ報告、一般的な相談に適しています。件名に問題の種類を記載し、本文にパスワード、秘密鍵、完全なトークンを含めないでください。
注文ID、レンタル期間、ノード、ストレージ拡張またはThunderbolt 5並列接続項目を記載してください。対応決済はUSDT-TRC20とVisa / Mastercard / Amex（Stripe）のみです。料金はすべて米ドル（USD）で決済され、利用可能なゲートウェイはバックエンドAPIの応答を基準とします。
2種類の機種、4つのレンタル期間、5つのノードから選択できます。専用物理マシンで仮想マシンではなく、開始価格は$21.5/日です。