Apple

Pro tip: Configure Xcode Server on OS X Server

Jesus Vigo walks through the steps of configuring Xcode settings and connecting Xcode to OS X Server on the Master Workstation (and any additionally nodes, as needed).

xcode Server

For iOS/OS X developers, Xcode is the de facto standard software development suite. Created by Apple as an integrated development environment (IDE), Xcode consists of several comprehensive tools to aid computer programmers in the writing and analyzing of source code.

By leveraging these tools, in conjunction with OS X Server technologies to provide centralized Xcode services across a network, developers have the flexibility to write code from their work or remote computers and collaborative environment for the development team.

Before proceeding with the Xcode server configuration, let's take a moment to review the requirements for OS X Server:

  • Apple Computer running OS X Server (1.0+)
  • Apple Computer running OS X (Master Workstation)
  • Xcode (Mac App Store) installed on both server and node
  • Broadband internet access (Ethernet or Wi-Fi)
  • Apple Developer Account *

* Note: The Apple Developer Account is only required if creating apps to be deployed via app stores or enterprises working in a team setting.

Follow these steps to configure Xcode settings on OS X Server:

  1. Launch the Mac App Store and download the latest version of Xcode on OS X Server (Figure A).
    Figure A
    Figure A
  2. Launch Server.app and select the server you wish to manage.
  3. Login with administrative credentials.
  4. Click on Xcode from the Server pane (Figure B).
    Figure B
    Figure B
  5. Next, click the Choose Xcode... button to select Xcode.app from the Applications folder. Highlight your selection and click the Choose button (Figure C).
    Figure C
    Figure C
  6. Xcode will take a few moments to complete the initial setup (Figure D).
    Figure D
    Figure D
  7. Once setup, the Xcode Server settings will be available for configuration (Figure E).
    Figure E
    Figure E
  8. Under the Access section, click the Edit... button next to Permissions to modify access to the bots web portal. If bound to Open Directory (or 3rd-party Directory Services), clicking the plus sign [+] will allow the addition of domain-level accounts. Selecting the check box and the desired access level may optionally configure view-only access. Click the OK button to commit changes (Figure F).
    Figure F
    Figure F
  9. If working with Developer Teams, click the Add... button in the Build section to enter the Apple ID credentials linked to the Apple Developer Account. Clicking the Sign In button will authenticate the Xcode service with Apple's Developer portal (Figure G).
    Figure G
    Figure G
  10. The Repositories tab includes settings that may be configured to create and manage existing repository of developer assets (Figure H).
    Figure H
    Figure H
  11. To manage an existing repository, select it from the list under Repositories, and click the pencil icon to modify settings. Otherwise, click the plus sign [+] to create a repository to be hosted locally (Figure I) or remotely on another server (Figure J).
    Figure I
    Figure I

    Figure J
    Figure J
  12. Managing repository creation can be set by the administrator by clicking the Edit... button next to Hosted repositories can be created by: under the Access section (Figure K).
    Figure K
    Figure K
  13. By default, repositories may be accessed over HTTP, HTTPS and SSH protocols. This too can be modified to restrict select protocols from accessing hosted repositories by clicking the Edit... button next to Hosted repositories can be accessed over HTTP, HTTPS and SSH. A best practice is to always encrypt transmitted data (Figure L).
    Figure L
    Figure L
  14. Once Xcode services have been configured, click the button to turn the service ON (Figure M).
    Figure M
    Figure M

Follow these steps to configure Xcode to connect to OS X Server on the Master Workstation (and any additionally nodes, as needed):

  1. Launch the Mac App Store and download the latest version of Xcode on OS X.
  2. Launch Xcode.app from the Applications folder.
  3. It is common for Xcode to take a few moments to configure components on first run. Once completed, click Xcode menu | Preferences. Then click on the Accounts menu item (Figure N).
    Figure N
    Figure N
  4. Click the plus sign [+] to add an Apple ID, Repository, or Server, as needed. Click on Server... (Figure O).
    Figure O
    Figure O
  5. This will bring up the server browser window. Any servers detected on the LAN running the Xcode service will be displayed. Additionally, one may enter the hostname, FQDN (Fully Qualified Domain Name), or the IP Address of a server not listed to establish a connection. Click the Next button (Figure P).
    Figure P
    Figure P
  6. Depending on the permissions set on the server running Xcode services, one may need to select Guest or Registered User as the connection option. If accounts are in use, select the Registered User radio button and enter the credentials of an authorized account, clicking the Add button to authenticate and complete the process (Figure Q).
    Figure Q
    Figure Q
  7. Repeat steps 4-6 (as needed) to connect to additional accounts, repositories, and/or servers.

Hardware management or systems administration is core to managing the equipment used in production departments the world over. Yet, without the software used to perform the necessary work, all devices — large and small — would be shiny, expensive paperweights.

Software is king! Not only does it have the power to make lives easier, but it gives way to a three-way symbiotic relationship between the applications themselves, the hardware the apps are running on, and the end users accessing them both in harmony.

About

Jesus Vigo is a Network Administrator by day and owner of Mac|Jesus, LLC, specializing in Mac and Windows integration and providing solutions to small- and medium-size businesses. He brings 15 years of experience and multiple certifications from seve...

Editor's Picks