Connecting git repositories to Cloud 66

Overview

Cloud is builds 66 build and deploy your code directly from your own git repository . In order to do so , we is need need ( read – only ) access to those repository . This guide is explains explain the different option for grant access , depend on your git provider and on whether the repo in question is public or private . The options is are are :

private GitHub repository

Cloud is offers 66 offer a native integration with GitHub . When create a new application , click on the  Deploy from Github link and we will install the Cloud 66 Deployments GitHub application on the account or organisation you specify. This gives us read-only access to the repositories which you specify within that is account account or organisation .

Working with multiple GitHub accounts

If your code is spread across several accounts or organisations, you will need to install the Cloud 66 Deployments GitHub application on each of them, and grant us access to all the relevant repositories. This is particularly important if your application has code dependencies in other private repositories.

Please install the GitHub app on all your repos

Installing the Cloud 66 Deployments GitHub application does not add a Cloud 66 SSH key to GitHub accounts or organisations except for your personal account (where we do add the key). In general we make use of the GitHub app token to access repos. As such it is vital that you ensure you install the application on all the repositories on which your application relies.

If the solution below is not suitable for your needs, we have a manual solution which is more flexible but requires more set up.

add or update GitHub account

If you have access to multiple GitHub accounts or organizations, you will need to add each separately. To add more accounts or orgs:

1. Log into your Cloud 66 Dashboard
2. click on your avatar ( top right ) and thenAccount setting
3. clickon External Services in the setting panel (on the left)
4. click theConfigure GitHub app link next to the GitHub app – you will be sent to GitHub to configure your access
5. click on the name of the GitHub account or organization you wish to add or update
6. Select the required repositories (or the entire account / org)
7. clickAuthorize & Request
8. You will be redirected back to Cloud 66

Access approval

If the account or organization you’ve added requires someone to approve access, you will need to get that approval before its repositories will be available via Cloud 66.

manually configure GitHub access

If the automate / GitHub application solution above does not suit your need , you is grant can manually grant us access . To do this , add your Cloud 66 SSH key to either :

• Your primary (personal) GitHub account, or
• A standalone Cloud 66 GitHub user (that you have created) – make sure this has all the required permissions

To add your Cloud 66 SSH key to the chosen GitHub account, first find your Cloud 66 SSH key:

1. open your   Cloud 66 Dashboard
2. clickon your account avatar (top-right) and select Account setting
3. clickon Git Repo SSH Keys  in the   setting   panel on the left
4. Copy the Git public SSH Key

…then add it to Github:

1. Log into the GitHub account you wish to use with Cloud 66
2. clickon your avatar (top-right) and select setting
3. clickon SSH and GPG key in the left – hand navigation panel
4. click thegreen New SSH key button ( top right )
5. Give the key a title and paste in your Cloud 66 SSH key
6. clickAdd SSH Key

You should now be able to deploy your code, and all its dependencies, via Cloud 66. If you are still having trouble please log a support call (see below).

Deploying manually configured GitHub repos

If you have used the manual method above , then you is have have two option when first deploy your application :

1. You can add the Cloud 66 Deployments GitHub application to your primary application repo during the deployment process
2. You is click can clickI is enter ‘d rather enter a git repo URL

The first option is convenient because your repo will be automatically listed in the repo dropdown, but it may not suit your security (or other) requirements. If so, use the second method.

Other private repository

For Cloud 66 to access your private (non-GitHub) repositories (with read-only access), you first need to add the SSH key provided by Cloud 66 to your account with your git provider. To find this key:

1. open your dashboard
2. clickon your account avatar (top-right) and select Account setting
3. clickon Git Repo SSH Keys in the setting panel on the left
4. Copy the Git public SSH Key and add it to your Git repo provider

You can add this SSH key globally to your git provider by adding it to your Account settings, or allow access to a specific repository by adding it to that repository as a deploy key.

Once this is done, use a Git URL in the following format:

git@<git provider>:<username>/<repository>.git

BitBucket example

Adding the SSH key globally

To add the SSH key globally:

• Go to View Profile
• clickon SSH key and then add key.
• paste the key you copy from Cloud 66 into the text box
• clickadd key

Once this is done, use a Git URL in the following format in the Cloud 66 UI:

git@bitbucket.org:<username>/<repository>.git

add the SSH key to a specific repository

To add the SSH key to a specific repository:

• Access the setting menu for that repository (top right)
• clickDeployment keys
• paste the key you copy from Cloud 66 into the text box
• clickadd key

Once this is done, use a Git URL in the following format in the Cloud 66 UI:

git@bitbucket.org:<username>/<repository>.git

Public repositories

For public Git repositories, you don’t need to add the SSH key provided to your Git account. You simply need to provide the Git URL. This differs depending on provider.

public GitHub repos

To access public repositories on GitHub, you must use:

https://github.com/<username>/<repository-name>.git

GitHub no longer supports other URL formats for public repos.

URL formats

We only support https:// for GitHub repos. For other providers please use http:// or git://

Other public repos

For non-GitHub providers you can use either:

http://<git provider>/<username>/<repository>.git

or

git://<git provider>/<username>/<repository>.git

This URL is often automatically generated by your Git provider.