Skip to content
This repository has been archived by the owner on Mar 16, 2023. It is now read-only.

Latest commit

 

History

History
56 lines (52 loc) · 3.96 KB

README.md

File metadata and controls

56 lines (52 loc) · 3.96 KB

Dedicated Hosts for macOS Preview Documentation

The purpose of this repository is to walk you through the details of the Dedicated Hosts for macOS preview on CircleCI.

What are dedicated host resources on CircleCI?

The dedicated host resource class is a new macOS option for those developing, building, testing, and signing iOS, iPadOS, macOS, WatchOS, and tvOS applications using the Xcode IDE. These dedicated resources provide an isolated environment for increased security. This resource class requires a 24-hour minimum lease and runs on Intel-based Mac hardware.

The identifier for the dedicated host resource is metal and supports Xcode v12.2.0 - 13.0.0 (see links below for image details).

Supported Xcode Images

Known Limitations

  • Does not currently support test splitting or parallelism
  • The host gets cleaned between jobs, which can take 5-45 minutes. We are working to bring this down to a consistent 5 minutes or less and are aiming to have this available in mid-January.

Pricing and Specs

Once a dedicated host has been allocated, you will have exclusive access to it for a minimum of 24 hours. If the dedicated host is already in use when a job is kicked off, an additional dedicated host will be reserved (with its own 24 hour lease window). Each account can currently have a maximum of three concurrent dedicated hosts. Any time over the initial 24 hours that a dedicated host is in use will be charged a per-minute overage rate (see table below for pricing details).

Resource Class Name vCPU Memory Storage Cost
metal 12 32 GB 200 GB 100 credits per minute (24-hour minimum)

Example of a CircleCI config using macOS dedicated host resources

# .circleci/config.yml
version: 2.1
jobs: # a basic unit of work in a run
  build-and-test: # your job name
    macos:
      xcode: 12.5.1 # indicate our selected version of Xcode
    resource_class: metal # dedicated host, with 24-hour billing
    steps: # a series of commands to run
      - checkout  # pull down code from your VCS
      - run: bundle install
      - run:
          name: Fastlane
          command: bundle exec fastlane $FASTLANE_LANE
      - store_artifacts:
          path: output
      - store_test_results:
          path: output/scan
          
workflows:
  build-test:
    jobs:
      - build-and-test

How to provide feedback & frequently asked questions

We will be sending a short, 2-question survey each week to gather feedback. You may also open an issue with any feedback or to report any issues that you encounter.

FAQ

  • Is there an Apple Silicon option for dedicated hosts?
    • We plan to support Apple Silicon hardware in the future, but that will not be included in this closed preview.
  • Why is there a 24-hour minimum?
    • Apple released an updated end-user license agreement (EULA) along with the release of Big Sur in November 2020, which requires cloud providers to lease Apple hardware to no more than one customer for a minimum of 24 hours.
  • How does a dedicated host differ from the other macOS resources on CircleCI?
    • Our other macOS resources are run on isolated virtual machines, which means that multiple customers can be using VMs on the same host. Dedicated hosts provide you exclusive access to an entire host, without worrying about sharing resources with other customers.