GitHub Partner Portal

Welcome to our new Partner Hub

2020-12-06T08:00:52+00:00

Welcome!

We’re happy to announce that we have launched our new Partner Hub! 🎉 The Partner Hub provides access to all the resources you need so that we can work together to create incredible experiences for our shared customers.

As a first step, evaluate which GitHub Partner Program to join. The Technology Partner program is for ISVs, integrators, and cloud service providers that want to extend the GitHub platform and co-market with us, while the Service and Channel Partner Program is for service-oriented and resell partners that want to deliver services to our joint customers and co-sell with us.

Partner Program Requirements

For the Technology Partner Program, see the Program Requirements section on the Technology Partners tab.
For the Channel Partner Program, see our Services & Channel Partners Handbook.

Where to get started

Get started by browsing through the below articles:

Technology Partners

Platform integration 101 slides - Overview of how to build technical integrations with GitHub
Learn GitHub Actions - Guide to help you use GitHub Actions to accelerate application development workflows
GitHub Apps 101 slides - Introduction to GitHub Apps
GitHub Technology Partner Program: Co-marketing with GitHub

Services & Channel Partners

GitHub Services & Channel Partners Handbook - Accelerate your business and help your customers reach their full DevOps potential
GitHub Channel Partner Value Proposition - Market opportunities, partner growth insights, and GitHub orientated offerings for partners

Partner Hub Updates

Check out our new Resources and Newsfeed sections:

Resources

The Resources section contains info on topics such as integration and go-to-market.

Newsfeed

We will continuously update the Newsfeed with key information such as partner-related product updates, events, and more. Stay tuned for our quarterly newsletter with all of our ecosystem updates.

Sponsorship Opportunities

2020-11-30T08:00:52+00:00

Leverage the GitHub brand to get in front of 1000’s of developers with our Sponsored opportunities.

GitHub Services & Channel Partners Handbook

2020-11-25T16:08:39+00:00

Overview

Welcome to the GitHub Services & Channel Partner Network! By partnering with GitHub, you can accelerate your business and help your customers reach their full DevOps potential.

Developers sit at the heart of any organization. And GitHub serves as a catalyst for driving cultural change within an organization, unifying developers across a single platform and breaking down silos.

GitHub partners can help customers realize the full value of a true DevOps culture.

The purpose of this handbook is to provide an overview of our partner programs and resources to help our partners provide joint value to customers and grow your business.

Documentation GitHub Services & Channel Partners Handbook

Github Channel Partner Value Proposition

2020-11-25T16:00:34+00:00

Market Opportunity - Over 50 million developers use GitHub today. Week by week, we are adding more and more customers across all segments. These customers choose GitHub to unlock the full potential of their development teams to help transform their organisations in a secure and compliant way. They need help to realize this journey. Few customers today are able to unlock the full potential of a mature DevOps approach, they need support from our partners to guide them realize their full potential.

Partner Growth Insights - Our most successful Services & Channel partners are looking to develop a Services practice centered around GitHub. These partners lead with services engagements, which our partners leverage to allow customers to get the most value out of GitHub. As we think about the future opportunities for partners and GitHub, our partners’ long-term success will be enhanced by building out their services capabilities. We see potential for growth around the Advanced Security space, and migration, innersource, app modernization, and digital transformation related services are some of the top partner offerings today.

GitHub Orientated Offerings For Partners - Build GitHub-orientated offerings and practice to engage customers in clearly defined scenarios.

Driving GitHub Deployment and Adoption - GitHub is being increasingly successful with acquiring large customers with large GH footprints. These customers require deep support to help them deploy and drive adoption of the customer base. Triangulating our joint customer lists here may be interesting to explore.
Extend GitHub Workloads in Customers:
- Drive Actions Adoption - migrations from other platforms and providing ongoing support for customers CI/CD journey
- GitHub Advanced Security - enabling customers to develop code that secure by design - move security to the left and leverage GHAS capabilities
Adding GitHub to existing offerings:
- Application Modernization - address the underlying root causes that created the need for applications to be modernized. If there was an effective SDLC /DevOps approach applications would be managed more effectively through their lifecycle
- Cloud Native App Development - when supporting customers develop new applications, use GitHub as the catalyst and enabler to accelerate the development cycle, write secure code by design and reduce time to deploy.
- Digital Transformation - Overall Digital Transformation engagement, help customers become software/technology customers. Requires them to invest in the Development capabilities and unlock the potential of their own developers.
- Innersourcing - Driving developer productivity, sharing and collaboration, writing a line of code only once, leveraging OpenS Source in secure ways…..
- **Journey to the Cloud **- Include Infrastructure Migrations (with Infrastructure as Code), moving development to the cloud, deploying applications to the cloud (New/Existing)

GitHub Technology Partner Program: Co-marketing with GitHub

2020-11-25T13:17:15+00:00

General guidelines

Before engaging in co-marketing, we ask our partners to have (or be in the process of producing) a GitHub integration such as a verified Action, Application, or public container image published to GitHub Packages onto the GitHub Marketplace. Partners must also be a part of the GitHub Technology Partner program.

Co-marketing

Joint go-to-market efforts may include co-branding support and social amplification for new integrations or user enablement. For advanced partners, we will consider additional tactics, such as partner-led webcasts, highlights within other GitHub-led content or blog, support for partner public product announcements, joint customer stories, or other items specific to each partner. Please work with your business development manager for more information.

Branding assets

Upon completion of a validated integration, partners can request a social card with their logo and an appropriate GitHub property logo based on their particular integration with GitHub (e.g. Actions, Packages, GitHub Application). Your business development manager will connect you with GitHub marketing teams to work with you on appropriate placement.

Tips on sending brand elements:

SVG files with transparent background are preferred
For flexibility, we request square and longitudinal aspect ratios, as well as dark- and light-colored logos for contrast against light and dark backgrounds
Please also send an SVG of your mark (for most companies, this is your logo, minus text of the company or product name)

Alternatively, you can send a URL for your branding guidelines to your GitHub business development manager or other GitHub marketing contact.

We love highlighting the work our partners do with us! We use two main social media channels, Twitter and LinkedIn. We will amplify:

announcements in which GitHub integrations are included, such as an Action or GitHub App in GitHub Marketplace, or a public container image within GitHub Packages (CTA in the announcement has to include the GitHub Marketplace URL)
walkthrough or how-to content on these integrations when they are on partner-led channels
virtual events in which both GitHub and the partner are participating, such as a webinar, or conference breakout session

We reserve the right to choose which channel(s) to use to amplify, based on our judgment of what will be of interest to the audiences on each. Some items may be a better fit for Twitter, some for LinkedIn; some will find a home on both. Posting is also subject to available space in the GitHub editorial calendar.

Partner-owned content + supporting quote from GitHub

Please let us know if you are planning to do any sort of owned content to discuss your GitHub integration, and would benefit from additional support from GiHub. We’ll want to know a few things:

Will there be a press release, blog, social content? If so, GitHub public relations and marketing will need to review to ensure GitHub and our products are being represented properly.
Are you seeking a supporting quote from GitHub? Please note - we can’t promise every partner a quote, and, if we do, we prefer that it be in support of announcements of new GitHub Actions or integrations that are verified within our Marketplace, or significant updates to existing integrations.
Is there any specific timeline you’re working against? It’s ideal for GitHub public relations to have at least a week to review partner-owned content, so insight into the timeline for publication of partner-owned content is imperative.

Partner integration spotlights

On occasion, we may highlight GitHub partner integrations through various customer or user communications channels, highlighting new integrations or partnerships. In these instances, we will proactively reach out to you to ask for 100-word summaries from our partners to include. These summaries should include an introduction to the technology partner and the product that is integrating with GitHub, along with a short description of the specific integration itself. GitHub public relations and marketing will need to review and approve the description for accuracy and messaging.

Potential partner integration spotlight channels include enterprise newsletters, round-up blog posts on partner integrations, or demos through our other online video channels such as Twitch.

For all other questions regarding co-marketing, please reach out through the partner portal, or to your assigned business development manager.

Setting up a CLI on GitHub’s hosted runners

2020-11-24T00:00:00+00:00

Problem statement

Many of GitHub’s Technology Partners wish to provide a way for developers to easily access their services via a configured CLI environment on GitHub’s hosted runners, for example, so that it is available in a CI/CD workflow.

The solution should :

Make it simple for developers to precisely describe the version of the CLI to be installed
Support multiple operating systems
Run in an efficient fashion to minimize run-time and associated costs
Work across hosted and self-hosted runners
Leverage community tooling when possible

Solution

Technology Partners should solve this by providing an action in a repo they maintain, written in, or compiled / transpiled to JavaScript. The action should be responsible for retrieving a specific version of the CLI, installing it, adding it to the path, and (optionally) caching it. Commonly this variety of action that performs some setup of a tool, is named **setup-$TOOL**. Refer to the examples below to see how this pattern is already in use in multiple ecosystems.

GitHub provides the actions/toolkit set of packages, which makes this process more straightforward across all of GitHub’s hosted runners.

Specifically, the actions/core and actions/tool-cache package expose operations that are commonly required in this scenario, in a cross-platform way.

Implementation

A simple cross-platform implementation in JavaScript follows, note, the implementation for getDownloadURL is intentionally absent, so that the example remains generic:

const core = require('@actions/core');
const tc = require('@actions/tool-cache');

async function setup() {
  // Get version of tool to be installed
  const version = core.getInput('version');

  // Download the specific version of the tool, e.g. as a tarball
  const pathToTarball = await tc.downloadTool(getDownloadURL());

  // Extract the tarball onto host runner
  const pathToCLI = await tc.extractTar(pathToTarball);

  // Expose the tool by adding it to the PATH
  core.addPath(pathToCLI)
}

module.exports = setup

Concrete implementation

A concrete implementation of this pattern is available here.

Examples

Example where this pattern is employed include:

For more information on creating a JavaScript action, refer to this guide.

Building blocks: Creating your own GitHub Actions with JavaScript

2020-11-10T00:00:00+00:00

This workshop was originally given at GitHub Universe 2019 and provides a conceptual overview of GitHub Actions and a guide of how to build your very own action using JavaScript.

Repo: Building Blocks: Creating Your Own GitHub Actions With JavaScript

Creating a GitHub App - Demo Days

2020-11-10T00:00:00+00:00

Steve Winton, Partner Engineer, explains why someone might want to build a GitHub app, then builds one from scratch. Create 3rd party integrations to GitHub via the API and allow them to act autonomously on protected resources. Using the example of OAuth, walk through GitHub Enterprise Server and learn how to build then manage administration, monitoring and installations.

Once you’ve built your app, consider partnering with GitHub.

Video: Demo Days - Creating a GitHub App

Getting started with Apps

2020-11-10T00:00:00+00:00

You can build integrations with the GitHub APIs to add flexibility and reduce friction in your own workflow. You can also share integrations with others on GitHub Marketplace.

Documentation: Getting started with apps

Creating a GitHub App from a manifest

2020-11-10T00:00:00+00:00

A GitHub App Manifest is a preconfigured GitHub App you can share with anyone who wants to use your app in their personal repositories. The manifest flow allows someone to quickly create, install, and start extending a GitHub App without needing to register the app or connect the registration to the hosted app code.

Documentation: Creating a GitHub App from a manifest

GitHub Partner Portal

Welcome to our new Partner Hub

Welcome!

Partner Program Requirements

Where to get started

Technology Partners

Services & Channel Partners

Partner Hub Updates

Resources

Newsfeed

Sponsorship Opportunities

GitHub Services & Channel Partners Handbook

Overview

Github Channel Partner Value Proposition

GitHub Technology Partner Program: Co-marketing with GitHub

General guidelines

Co-marketing

Branding assets

Social amplification

Partner-owned content + supporting quote from GitHub

Partner integration spotlights

Setting up a CLI on GitHub’s hosted runners

Problem statement

Solution

Implementation

Concrete implementation

Examples

Related

Building blocks: Creating your own GitHub Actions with JavaScript

Creating a GitHub App - Demo Days

Getting started with Apps

Creating a GitHub App from a manifest