接続できない
デバイスに到達できないのか、認証情報に問題があるのかを確認
コンソール上のデバイス状態、SSHまたはVNCのエラーメッセージ、ローカルのネットワーク環境、初回発生時刻、特定の接続方法だけで失敗するかを記録してください。
準備する情報：ノード、接続元ネットワーク、エラー、時刻
クラウドMacのテクニカルサポート
問題の範囲を特定し、再現可能な情報をお送りください
接続の問題はデバイスの状態と認証情報から、ビルドの問題はXcode、依存関係、署名環境から確認します。CDNMacは専有の物理Macを提供しており、仮想マシンではありません。プロジェクトコード、開発者アカウント、署名用資産はお客様ご自身で管理してください。
ご注文済みの場合は、注文ID、選択したノード、発生時刻、機密情報を除いたログを添えてください。実際のデバイス状態と利用可能な操作は、コンソールの最新情報をご確認ください。
6つの窓口
接続・ビルド・署名・ネットワーク・請求・ノード別に案内
6つの情報
問い合わせに必要な情報をまとめて準備
365日稼働
ノードは年間365日稼働
問題の引き継ぎ記録
症状から再現手順まで
情報がそろったら対応キューへ
01
問題の範囲を確認
影響があるのは1台のデバイス、1つのリポジトリ、1回のビルドなのか、すべての接続方法なのかを記録します。
- デバイスの状態
- コンソールの最新情報を確認
- 選択したノード
- 注文に対応するリージョンを記録
02
問題の発生箇所を絞り込む
ネットワーク、システムアクセス、ツールチェーン、プロジェクトの依存関係、署名の各手順を個別に確認し、複数の設定を同時に変更しないでください。
- 最小限の再現手順
- 再現できる手順を記録
- 発生時刻
- 初回と直近の発生時刻を記載
03
調査に必要な情報を共有
機密情報を除いたログ、期待する結果、試した操作をお送りください。秘密鍵、トークン、証明書のパスワード、完全な決済情報は送信しないでください。
- ログの範囲
- コマンド、処理段階、タイムスタンプを含める
- 期待する結果
- 正常時の状態を説明
まず問題の種類を選択
6つの窓口と、種類ごとに必要な情報
主な症状に合わせて分類し、該当する情報を準備してください。1件の問い合わせにつき主な問題は1つに絞り、関連する症状は再現手順に記載できます。
ビルドに失敗する
どのビルド段階で失敗したかを特定
XcodeとCommand Line Toolsのバージョン、使用したロックファイル、失敗したコマンド、対象scheme、空きディスク容量、ログに最初に現れる有効なエラーをお知らせください。
準備する情報：バージョン、コマンド、段階、機密情報を除いたログ
署名の問題
証明書、プロビジョニングプロファイル、対象設定を確認
機密情報を除いた署名エラー、bundle identifier、対象環境、証明書の有効状態をお送りください。証明書のパスワード、秘密鍵、使用可能な状態のトークンは送信しないでください。
準備する情報：対象、識別子、有効状態、エラー
ネットワークの問題
往復遅延と実際のダウンロード経路を分けて確認
接続元のプロバイダー、ネットワーク種別、対象ノード、連続測定の中央値を記録し、リポジトリの取得や依存関係のダウンロードにも同様の問題があるか確認してください。
準備する情報：プロバイダー、ネットワーク種別、測定値、対象
請求に関する質問
注文項目に沿って基本構成と追加オプションを確認
注文ID、レンタル期間、基本構成、SSDまたはThunderbolt 5の並列接続オプション名をお知らせください。チケットに完全な決済情報を記載しないでください。
準備する情報：注文、期間、構成、追加オプション
ノードの移行
移行の理由とデータの引き継ぎ範囲を説明
現在のノード、希望する接続先の方向、引き継ぐ作業ディレクトリと成果物を記載し、環境の再構築が可能かどうかもお知らせください。選択できる範囲はコンソールの最新情報をご確認ください。
準備する情報：現在のノード、接続先の方向、データの範囲
接続のトラブルシューティング
決まった順序で確認し、ネットワークの問題をデバイス故障と誤認しない
各手順の結果を記録してから次へ進んでください。調査中に鍵の交換、ファイアウォールの変更、ローカルネットワークの再起動を同時に行うと、原因を特定しにくくなります。
01
デバイスの状態を確認
まずコンソールで注文とデバイスの状態を確認し、現在のノードとデバイスIDを照合します。状態が変化中の場合は、コンソールに安定した情報が表示されてから接続を試してください。
02
アクセス認証情報を確認
現在のデバイスに対応するシステムユーザー名、ホストアドレス、最新の認証情報を使用していることを確認してください。別の注文の接続情報を使い回さないでください。
03
SSH接続を確認
信頼できるネットワークから、ホストとポートに到達できるかテストし、鍵ファイルの権限と認証エラーを確認してください。タイムスタンプ付きのエラーを保存し、秘密鍵の内容は送信しないでください。
04
VNCセッションを確認
SSHは正常で画面セッションに問題がある場合は、VNCクライアント、接続段階、画面の状態を個別に記録してください。画面セッションの問題を基本的なネットワーク障害として扱わないようにします。
05
ローカルのファイアウォールを確認
社内ネットワーク、VPN、外向き通信のポリシー、ローカルのファイアウォールが対象ポートを制限していないか確認してください。問題がローカルの接続経路にあるか判断するため、別の信頼できるネットワークから再度テストできます。
pingの1回の結果で分かるのは、その時点のネットワーク往復時間だけです。VNCの操作感、依存関係のダウンロード速度、ビルド全体の所要時間を直接示すものではありません。継続的な測定と実際のタスクで確認してください。
ビルドのトラブルシューティング
ツールチェーンのバージョンから最初の有効なエラーまで確認
ビルドログには後続のエラーも連鎖して記録されることがあります。まず処理を中断させた最初の有効なエラーを特定し、関連するツール、依存関係、署名、ディスクの状態を確認してください。
Xcodeと対象SDK
Xcodeの完全なバージョン、対象プラットフォーム、scheme、configuration、実際に呼び出されたツールのパスを記録してください。GUIとコマンドラインで使うバージョンは統一します。
Command Line Tools
選択中の開発者ディレクトリが想定のバージョンと一致することを確認してください。Xcodeをアップグレードした後は、コマンドラインツールの参照先を再確認し、スクリプトが古いパスを呼び出さないようにします。
依存関係とロックファイル
プロジェクトで使用しているロックファイルを保持し、依存関係の復元コマンドとキャッシュの設定を記録してください。まずクリーンな作業ディレクトリで再テストし、キャッシュの問題かどうかを判断します。
証明書とプロビジョニングプロファイル
有効状態、bundle identifier、対象環境、署名設定が一致するか確認してください。送信するのは機密情報を除いたエラーのみとし、秘密鍵や証明書のパスワードは含めないでください。
空きディスク容量と一時ディレクトリ
ソースコード、依存関係のキャッシュ、DerivedData、Archive、エクスポート成果物が使用する容量を確認してください。空き容量が不足する場合は、再作成可能なキャッシュから削除します。
ログのタイムスタンプと失敗段階
タスク開始、最初のエラー、タスク終了の3つの時刻を記録し、依存関係の復元、コンパイル、Archive、署名、エクスポートのどの段階で失敗したかを明記してください。
CI/CD連携
専有の物理Macを管理されたself-hosted runnerとして登録
CDNMac M4は、リポジトリのイベントをきっかけにしたiOSビルドを実行できます。GitHub Actions、GitLab CI、JenkinsなどのCI/CDシステムに接続する際は、一時的なコンテナではなく、継続的に稼働するビルドホストとして管理してください。
- リポジトリごとに専用の作業ディレクトリを用意し、複数のプロジェクトで未清掃のビルドキャッシュを共有しないでください。
- トークンにはタスク実行に必要な最小限の権限だけを付与し、リポジトリごとに個別に設定してください。
- 署名情報はアクセスを制限した場所に保管し、パイプラインのログに鍵、トークン、証明書のパスワードを出力しないでください。
- タスク終了後に一時ファイル、派生データ、不要になった成果物のコピーを削除してください。
- runnerに明確なラベルを設定し、互換性のないタスクが誤って割り当てられないようにしてください。
ビルドタスク引き継ぎ票
RUNNER / M4
A1
キュー
信頼できるタスクを受け付ける
リポジトリ、ブランチ、runnerラベルに基づいてタスクを受け付けるか判断します。
B2
ワークスペース
依存関係を復元
ロックファイルとリポジトリ専用キャッシュを使い、キャッシュのヒット状況を記録します。
C3
アーカイブ
Archiveを実行
Xcodeのパス、scheme、configuration、エクスポート設定を固定します。
D4
成果物
成果物を納品してクリーンアップ
必要な成果物をコピーした後、一時ディレクトリを削除し、機密情報を除いた診断ログを保管します。
分離単位：リポジトリ
認証情報の方針：最小権限
クリーンアップの時期：タスク終了後
用語集
よく使う8つの用語と基本の確認ポイント
問い合わせで用語を統一すると、物理デバイス、アクセス方式、自動化の実行環境、最終成果物をすばやく区別できます。
- クラウドMac
- ネットワーク経由でリモート利用するMacです。CDNMacは専有の物理Macを提供し、1台のデバイスを複数の注文で共有することはありません。
- 物理ノード
- デバイスが実際に設置され、ネットワークに接続されている地域です。選択する地域は接続経路に影響しますが、ビルド全体の所要時間を単独で決めるものではありません。
- 専有
- 1件の注文につき1台のデバイスと、そのリソースおよびアクセス環境を割り当てます。計算リソースを複数のお客様で分割して利用することはありません。
- 仮想マシンではない
- ワークロードは実際のMacハードウェア上で実行されます。1台のホストを複数の仮想インスタンスに分割する方式ではありません。
- VNC
- macOSのグラフィカルな画面にアクセスするリモート接続方式です。画面の状態確認やGUI操作が必要なタスクに適しています。
- SSH
- コマンドライン操作、スクリプト実行、ファイル転送に使う暗号化接続方式です。自動化タスクや日常的なシステム操作に適しています。
- self-hosted runner
- CIシステムに登録し、チームが自ら管理するタスク実行環境です。指定したクラウドMacでパイプラインのタスクを受け取り、実行します。
- ビルド成果物
- コンパイル、Archive、エクスポートで生成されるファイルと必要なログです。チームが管理するストレージにコピーし、保存期間を設定してください。
問い合わせ前の準備
6項目をそろえてからコンソールで問い合わせ
短いメッセージを何度も送るより、必要な情報をまとめた方が問題を再現しやすくなります。機密情報は種類と状態だけを説明し、そのまま使用できる内容は送信しないでください。
01
注文ID
該当する機種、レンタル期間、デバイス記録を確認できるよう、コンソールに表示される注文IDまたはデバイスIDをお知らせください。
02
選択したノード
現在のデバイスがあるノードを記載してください。「アジア」や「米国」だけではなく、ノードを具体的にお知らせください。移行を希望する場合は、接続先の方向も記載してください。
03
発生時刻
初回発生、直近の再現、タスク終了の各時刻を記録し、デバイスやネットワークの記録と照合できるようタイムゾーンも記載してください。
04
再現手順
入力内容、コマンド、対象、結果を順番に記載してください。毎回発生するとは限らない場合は、発生頻度と条件もお知らせください。
05
機密情報を除いたログ
エラーの前後の状況とタイムスタンプを残し、秘密鍵、トークン、証明書のパスワード、個人情報、完全な決済情報を削除してください。
06
期待する結果
正常時に表示されるはずの状態、ファイル、戻り値を説明し、すでに試して効果がなかった操作も列挙してください。
サポート範囲
当社がサポートすること、チームで管理いただくこと
デバイスとネットワーク、システムアクセス、ツールチェーンの助言、プロジェクト固有の責任を切り分けることで、誤った箇所の設定変更を繰り返さずに済みます。
ハードウェアとネットワークの状態
デバイスの状態、ノード側のネットワーク、注文との対応関係、コンソールに表示される管理状態を確認し、再現可能な情報に基づいて対応します。
CDNMacのサポート範囲システムアクセスのサポート
デバイスに到達できるか、認証情報が現在のデバイスに対応しているか、SSHやVNCの問題がネットワーク、認証、セッションのどの層にあるかを確認します。
CDNMacのサポート範囲ビルドツールのトラブルシューティング
ログに基づいてXcode、Command Line Tools、ディスク、ビルド段階の確認を支援します。プロジェクトの依存関係とスクリプトは、プロジェクトチームで検証してください。
共同で確認する範囲プロジェクトと開発者情報
プロジェクトコード、開発者アカウント、証明書、プロビジョニングプロファイル、アクセスキー、ソフトウェアライセンス、依存関係のバージョン、ワークロードの適法性は、お客様ご自身で管理してください。
お客様の管理範囲
セキュリティに関する注意
認証情報、署名情報、ビルド成果物を一連の終了手順で管理
専有デバイスはリソース共有のリスクを抑えますが、チームによる権限管理に代わるものではありません。初回接続、継続利用、レンタル終了の各段階で、明確な手順を用意してください。
最小限の権限を付与
CIトークン、リポジトリキー、自動化アカウントには、現在のタスクに必要な権限だけを付与してください。複数のプロジェクトで、同じ高権限の認証情報を長期間共有しないでください。
認証情報を定期的に更新
鍵とトークンの更新履歴を管理してください。メンバー、リポジトリ、タスクの範囲が変わった場合は、不要になったアクセス権を速やかに取り消してください。
期限切れの証明書を削除
証明書とプロビジョニングプロファイルの有効状態を定期的に確認し、使わなくなったコピーを削除してください。古い設定がパイプラインで誤って選択されるのを防げます。
必要な成果物を事前にエクスポート
レンタル終了前に、ソースコードの変更、ビルドログ、Archive、必要な成果物をチーム管理のストレージにコピーし、ファイルを読み取れることを確認してください。
問題を再現できましたか？必要な情報をそろえてコンソールからお問い合わせください
注文ID、ノード、発生時刻、再現手順、機密情報を除いたログ、期待する結果をお送りください。鍵、トークン、証明書のパスワードは平文で送信しないでください。