> ## Documentation Index
> Fetch the complete documentation index at: https://notes.kodekloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# CodeCommit Demo
> This tutorial guides users through using AWS CodeCommit in a CI/CD pipeline, covering repository creation, file management, branch handling, and pull request workflows.
Welcome to this comprehensive tutorial on using **AWS CodeCommit** as your source stage in a CI/CD pipeline. You’ll learn how to:
* Create a CodeCommit repository
* Upload and manage files
* Work with branches
* Open and merge a pull request
Feel free to follow along in your own AWS account!
AWS CodeCommit seamlessly integrates with other AWS Developer Tools. You can also connect it to your local Git client for advanced workflows.
***
## Table of Contents
1. [Create a Repository](#create-a-repository)
2. [Upload Files](#upload-files)
* appspec.yml
* before-install.bat
* index.html
3. [Branch Management](#branch-management)
4. [Pull Request Workflow](#pull-request-workflow)
5. [Merge and Verify](#merge-and-verify)
6. [Conclusion & References](#conclusion--references)
***
## Create a Repository
1. Sign in to the AWS Management Console and open **CodeCommit**.
2. Click **Create repository**.
3. Provide a name (e.g., `MyDemoRepo`) and an optional description.
4. Click **Create**.
***
## Upload Files
Start by adding the deployment configuration and application assets.
| File | Description |
| ------------------ | ------------------------------------------ |
| appspec.yml | Defines deployment hooks and file mappings |
| before-install.bat | Installs IIS on Windows target |
| index.html | Sample HTML page for testing deployment |
### 1. Upload `appspec.yml`
1. In the repository, click **Add file** > **Upload file**.
2. Select your local `appspec.yml`.
3. Enter author name, email, commit message (optional), and click **Commit changes**.
```yaml theme={null}
version: 0.0
os: windows
files:
- source: \index.html
destination: C:\inetpub\wwwroot
hooks:
BeforeInstall:
location: \before-install.bat
timeout: 900
```
### 2. Upload `before-install.bat`
1. Click **Add file** > **Upload file**.
2. Choose `before-install.bat` from your machine.
3. Fill in author details and click **Commit changes**.
```bat theme={null}
REM Install Internet Information Server (IIS).
c:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -Command Import-Module -Name ServerManager
c:\Windows\Sysnative\WindowsPowerShell\v1.0\powershell.exe -Command Install-WindowsFeature Web-Server
```
### 3. Upload `index.html`
1. Click **Add file** > **Upload file**.
2. Select `index.html`.
3. Add author info and commit.
```html theme={null}
Sample Deployment
Deployment Successful
Welcome to AWS CodeCommit
```
***
## Branch Management
1. Select **Branches** in the sidebar. You’ll see the default branch named `main`.
2. Click **Create branch**, enter `branch2` as the new branch name, and choose `main` as the source.
3. Click **Create**.
Use descriptive branch names that reflect the feature or fix you’re working on.
### Edit a File in `branch2`
1. Switch to `branch2`.
2. Open `appspec.yml` and click **Edit**.
3. Add a comment line at the end, then commit your changes.
```yaml theme={null}
version: 0.0
os: windows
files:
- source: \index.html
destination: C:\inetpub\wwwroot
hooks:
BeforeInstall:
location: \before-install.bat
timeout: 900
# Demo Testing
```
***
## Pull Request Workflow
1. Click **Pull requests** in the sidebar.
2. Click **Create pull request**.
3. Set **Source** to `branch2` and **Destination** to `main`, then click **Compare**.
Review the changes:
```diff theme={null}
BeforeInstall:
location: \before-install.bat
timeout: 900
+ # Demo Testing
```
4. Enter a title like **Demo Pull Request** and an optional description.
5. Click **Create pull request**.
***
## Merge and Verify
1. In the pull request view, click **Merge**.
2. Select **Fast-forward merge** and confirm.
3. Optionally uncheck **Delete branch** if you wish to preserve `branch2`.
```bash theme={null}
# You can also merge locally:
git fetch origin
git checkout main
git merge --ff-only origin/branch2
```
Deleting a branch removes its history in the console view. Make sure you no longer need it before deleting.
### Verify on `main`
Switch back to `main` and open `appspec.yml` to see the merged comment:
```yaml theme={null}
version: 0.0
os: windows
files:
- source: \index.html
destination: C:\inetpub\wwwroot
hooks:
BeforeInstall:
location: \before-install.bat
timeout: 900
# Demo Testing
```
***
## Conclusion & References
You’ve successfully created a CodeCommit repository, uploaded files, managed branches, and completed a pull request merge—all via the AWS Console.
Next, explore how to integrate CodeCommit with AWS CodeBuild and CodeDeploy for automated builds and deployments.
### Useful Links
* [AWS CodeCommit Documentation](https://docs.aws.amazon.com/codecommit/latest/userguide/)
* [Getting Started with AWS CodeCommit](https://docs.aws.amazon.com/codecommit/latest/userguide/what-is-codecommit.html)
* [AWS Developer Tools](https://aws.amazon.com/developer/tools/)