Skip to main content

Managing Runners

Monitoring Self-hosted Runners​

When you add a new self-hosted runner to your organization, it appears at "Self-hosted Runners" list with Offline state. You can see your runner in list with given name and pool from CLI.

After configuring and starting runner service, it becomes Online on list.

Self-hosted runners list has also other quick details which give your overview for your runners.

  • "Version" is your self-hosted runner's version, you got from CLI.
./ac-runner --version
  • "Last Contact" shows when Appcircle cloud has last contact with your self-hosted runner.

  • "State" shows your self-hosted runner's current build status. For example, it can be idle when runner is waiting for a build job and running when it's executing build job.

Screenshot

You can disable self-hosted runner from list, using toggle button on right-hand side. When runner is disabled, it won't accept build job anymore. Disabling runner, doesn't affect currently running build pipeline on runner. It will complete its executing job. When complete, it won't take any new build job from queue until you enable it again. Using same toggle button you can enable self-hosted runner.

With quick enable/disable feature, you can remove self-hosted runner from pool temporarily and make some maintenance or debugging. When ready, you can add the self-hosted runner to pool again without any CLI operation.

danger

Your pool should have at least one active (ready-to-build) runner for build pipeline continuity.

If your pool is assigned to an active build profile but doesn't have any active runners, started build jobs from that profile will wait in queue until timeout.

For this reason, you should think about your pool organization and build profile settings while removing or disabling self-hosted runners.

Move Self-hosted Runner Between Pools​

For some reason, you may need to move your runner from one pool to another. For this purpose, use below command:

./ac-runner install -p ${Runner Pool}

Runner pool argument must be new target pool to move self-hosted runner.

If there is no runner left in old pool, it will be deleted automatically and disappear from build profile pool selection list.

If new target pool doesn't exist, it will be created automatically.

info

Moving self-hosted runner from one pool to another doesn't require service restart. Change will be activated immediately without any manual intervention.

Delete Self-hosted Runner​

If you want to remove your self-hosted runner for any reason, click on runner name to open details view. Here you can see details of your runner. (its pool, create and update times etc.)

Screenshot

Click on delete button at the bottom of the page. A confirmation dialog will be visible for your approval. Type runner name into textbox and click on delete.

Deleting runner removes it from pool and it's unreachable from Appcircle cloud. If you want to add same runner again to the same pool or another pool, you need to register and configure it again. See, add self-hosted runner page for details.

info

Removing or deleting runner from pool doesn't affect running build job on that runner. On-going build job will be completed but that runner won't get any new build job from queue.

info

If there is no runner left in self-hosted pool, it will be deleted automatically and disappear from build profile pool selection list.

danger

When a self-hosted pool is deleted from organization for any reason, its related build profiles will return to default pool automatically which is Appcircle cloud. So, build jobs will go on with Appcircle-hosted runners automatically.

Adding Xcode After Install​

caution

Installing Xcode through the runner (./ac-runner xcode -v) is no longer supported for Xcode 16 and later. It only covers Xcode 15.4 and earlier, which can't be used to submit apps to the App Store.

To get newer Xcode versions, use the macOS VM image and upgrade to a newer image release when you need a newer Xcode. Each image comes with its Xcode versions preinstalled. If you need an Xcode version that isn't included in the image, you can install it manually on your base VMs as explained in Update Base Images.