Customize Bluemix with your Git servers

5 min read

By: Brianna Wegryn

Introducing a new DevOps toolchain feature

You can now interact with your own GitHub Enterprise and GitLab instances from Bluemix public!

Both the GitHub and GitLab tiles feature a new server dropdown menu, giving you the freedom to work with code on GitHubGitLab, or in your own company’s GitHub Enterprise or GitLab instances.

To get started interacting with your custom instance, follow the one-time setup instructions below. Then, whenever you load the GitHub or GitLab tile, you will see your custom instance appear in the server dropdown menu. From there, you have the same freedom to create, fork, or clone repositories. If you have existing repositories, you can link those as well.

In addition, you can interact with your repositories using a variety of Bluemix DevOps tools. For example, you can edit your code in Eclipse Orion Web IDE; build, test, and deploy your code with Delivery Pipelines; and analyze your code with DevOps Insights.

Introducing a new DevOps toolchain feature

Prerequisites for custom server interaction

  • The server must be accessible via the public Internet.

  • You must be able to provide the root URL and a personal access token.

  • This setup must be done per individual looking to interact with the custom instance.

One-time setup

  1. First, navigate to the toolchain catalog from a new or existing toolchain.

  2. Then, choose the GitHub or GitLab tool based on your instance.
    GitHub

    GitLab

  3. Next, select Add a custom server from the server dropdown menu.

  4. Provide a title to identify your server in the dropdown menu. It will appear in the format “Title (root URL)”.

  5. Provide the root URL of your server.

  6. If you already have a personal access token, proceed to step #7. Otherwise, complete the following steps depending on whether you are using GitHub or GitLab.

    Instructions to retrieve your GitHub personal access token

    1. On any GitHub page, click your profile icon and then click Settings.

    2. On the sidebar, click Personal access tokens.

    3. Click Generate new token.

    4. Add a description for the token.

    5. Select the repo and user checkboxes to define the access for the personal token.

    6. Click Generate token.

    7. Copy the token to a secure location or password management application. For security reasons, after you leave the page, you will no longer be able to see the token.

    Instructions to retrieve your GitLab personal access token

    1. On any GitLab page, click your profile icon and then click Settings.

    2. Click on the Access Tokens

    3. Provide a name for the token.

    4. (Optional) Choose an expiration date for the access token.

    5. Select the api checkbox to define the access for the personal token.

    6. Click Create personal access token.

    7. Copy the token to a secure location or password management application. For security reasons, after you leave the page, you will no longer be able to see the token.

  7. Provide a personal access token. **Note** You will be the only user of your token. When you’ve done all this, it should look like the screen shot below:
    GitHub

  8. Finally, click Save custom integration.

When your custom server has been verified, the page will reload with your custom instance selected in the dropdown menu. You can now use your Git instance with Bluemix public!

Save custom integration

To learn more about available toolchain templates and our Garage Method, visit the IBM DevOps Toolchainssite. And, let us know how it works for you! Feel free to post comments or questions below!

Be the first to hear about news, product updates, and innovation from IBM Cloud