Setting up External Workers

IMPORTANT: The Concourse for PCF tile is currently in Beta and is meant for evaluation and test purposes only. Do not use this product in a PCF production environment.

This topic describes how to run Concourse workers on native hardware platforms, OSX or Windows. An example use case for an external worker is having it run pipelines that produce binary artifacts using Xcode, such as mobile apps. For more information, see the Standard Binary topic in the Concourse documentation.

Follow the procedure below to set up an external worker:

  1. Create a Concourse Service Instance.

  2. Download the latest Concourse binaries for your target platform, OSX or Windows, from the Concourse Downloads page.

  3. Run the following command to generate a private key and public key in your local directory.

    $ ssh-keygen -t rsa -f worker_key -N ''
    

  4. Load the public key into the Concourse tile:

    1. In Ops Manager, click the Concourse tile.
    2. Click the External Worker Keys tab.
    3. Click Add.
    4. Enter the team name for the instance you created. For information on finding your team name, see the Creating Concourse Instances topic.

      Note: To register a worker with a team, you must enter the exact name of the team as displayed in the Concourse UI.

    5. In the SSH key field, enter the contents of the worker_key.pub file that you generated.
    6. Click Save.
    7. Click Apply Changes to deploy the tile with the new SSH key.
  5. Once the deploy finishes, obtain the public RSA key for your Concourse instance using one of the following options:

    • For additional security, Pivotal recommends asking your operator to provide the SSH key by accessing the Concourse VM through SSH and running the following command:
      $ ssh-keyscan -p 2222 localhost >host_key.pub
      
    • As a less secure alternative, you can use ssh-keyscan and save it to a local file:
      $ ssh-keyscan -p 2222 localhost >host_key.pub
      
  6. Run the following command to register the Concourse worker with your Concourse instance:

    $ sudo ./concourse worker --work-dir /tmp --tsa-host https://p-concourse.YOUR-SYSTEM-DOMAIN --tsa-public-key host_key.pub --tsa-worker-private-key worker_key --team TEAM-NAME

  7. Verify that the new worker registered successfully.

    1. Target your Instance with the Fly CLI:
      $ fly -t TARGET-NAME login -n TEAM-NAME
      
    2. Run the following command to see your new worker.
      $ fly -t TARGET-NAME WORKER-NAME
      
Create a pull request or raise an issue on the source for this page in GitHub