Adding a Repository as a Remote

You can add a Cloud Source Repository as a remote to a local Git repository and use it in the same way you use other Git remotes.

Before you begin

  1. Select or create a Cloud Platform project.

    Go to the Manage resources page

  2. Install Git.
  3. Install and initialize the Cloud SDK.
  4. Create a Cloud Source Repository

Adding the repository as a remote

  1. Change your current working directory to the directory that contains your local Git repository:

  2. Run the credential helper script (on Linux or Mac OS X):

    git config credential.helper

    Or on Windows:

    git config credential.helper gcloud.cmd

    The credential helper scripts provide the information needed by Git to connect securely to the Cloud Source Repository using your Google account credentials. You don't need to perform any additional configuration steps (for example, uploading ssh keys) to establish this secure connection.

    Note that the gcloud command-line tool must be in your $PATH for the credential helper scripts to work.

    If you cannot use the gcloud tool (e.g. you are on a build server)

    You may use static credentials by manually generating them in the cloud-console.

    • Go to the repository page and click the clone button, then change the preferred authentication method to manually generated credentials and follow the instructions to use the generated credentials.
  3. Add the Cloud Source Repository as a remote:

    gcloud source repos create [YOUR_REPO]
    git remote add google\[PROJECT_ID]/r/[YOUR_REPO]

    where [PROJECT_ID] is the ID of your Cloud Platform project and [YOUR_REPO] is the name of your Cloud Source Repository.

Using the repository as a remote

A Cloud Source Repository is a fully-featured Git repository. You can use the standard set of Git commands to interact with the repository, including push, pull, clone and log.

Pushing to a Cloud Source Repository

To push from your local Git repository to the Cloud Source Repository:

git push google master

Pulling from a Cloud Source Repository

To pull from the Cloud Source Repository to your local Git repository:

git pull google master

Viewing the commit history from a Cloud Source Repository

To view the commit history:

git log google/master

What's next

After you have pushed source files to the Cloud Source Repository, you can view repository files from within the Google Cloud Platform Console.

Send feedback about...

Cloud Source Repositories