Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added src/assets/codebuild-connect-github.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/assets/codebuild-create-connection.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed src/assets/codebuild-popup.png
Binary file not shown.
Binary file added src/assets/codebuild-save-default-credential.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed src/assets/codebuild-source.png
Binary file not shown.
22 changes: 17 additions & 5 deletions src/tutorials/deploy-first-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,15 +49,27 @@ You'll be prompted with some questions about the application. You can respond as

### 🤝 Connecting GitHub to CodeBuild

The first time you setup an app from GitHub, you'll be prompted to connect AWS CodeBuild with your GitHub account. Unfortunately, doing this is a little bit awkward. You'll be directed to a page in your browser which requires scrolling down to the *Source* section.
The first time you set up an app from GitHub, you'll be prompted to connect AWS CodeBuild to your GitHub account. AppPack opens the CodeBuild **default source credentials** page in your browser.

![CodeBuild Source section](../assets/codebuild-source.png)
Make sure the **Source Provider** is `GitHub` and the **Credential type** is **GitHub App**, then choose **create a new GitHub connection** (or pick an existing one from the **Connection** dropdown).

Choose `GitHub` in the "Source provider" input, select "Connect using OAuth", and click the "Connect to GitHub" button. You should be presented with a popup window to confirm the connection.
![Manage default source credential](../assets/codebuild-default-source-credential.png)

![CodeBuild popup window](../assets/codebuild-popup.png)
Give the connection a name and click **Connect to GitHub**.

Once you've clicked "Confirm" in that popup, you've completed the connection. You can close the browser and continue on the command line.
![Create a GitHub App connection](../assets/codebuild-create-connection.png)

This opens a GitHub authorization page. Choose the GitHub account or organization that owns your repository and authorize the *AWS Connector for GitHub* app, installing it if you haven't already. Complete the installation on GitHub.

<!-- TODO(#82): optional screenshot of the GitHub authorization / app installation page (on github.com) -->

You're returned to the **Connect to GitHub** page with the **App Installation** ID populated. Click **Connect**.

![Connect to GitHub](../assets/codebuild-connect-github.png)

Back on the **default source credentials** page, select your new connection and click **Save**. You can then close the browser and continue on the command line.

![Save the default source credential](../assets/codebuild-save-default-credential.png)

---

Expand Down
Loading