MacOS on AWS debugging playbook / logs / dashboards
We need to have tooling and a playbook for debugging issues with AWS MacOS runner instances. This should cover at least the following:
- How to determine if the AWS MacOS runner instance group is healthy. Links to logs and metrics.
- How to SSH into a Mac instance. How to subsequently SSH into a nested VM.
- How to debug nesting client/server. Links to logs on host.
- How to list, delete nested VMs (tart commands).
- How to debug Taskscaler-driven health checks.
- How to replace all instances in an ASG.
- How to debug networking between Runners in GCP to instances in AWS to nested VMs inside macs.
MRs:
-
AWS ASG health and SSHing into a Mac instance 👉 docs: Add MacOS runners debugging guide and SSH... (gitlab-com/runbooks!8893 - merged) • Davis Bickford -
Debugging nesting 👉 docs: Add debugging instructions for MacOS runn... (gitlab-com/runbooks!8927 - merged) • Davis Bickford • 18.1 -
Runner projects and config locations 👉 docs: Add projects overview and Terraform confi... (gitlab-com/runbooks!8976 - merged) • Davis Bickford -
Add AWS account details and debugging guidance for macOS runners 👉 docs: Add AWS account details and debugging gui... (gitlab-com/runbooks!9013 - merged) • Davis Bickford -
Add notes from recent document by @joe-shaw https://docs.google.com/document/d/1zYbQD1DDvvuDxczYa4c8omQjO2RcS-6VRw5650E0Pxw/edit?tab=t.0
Edited by Davis Bickford