Configure and Work with CodeCommit from the CLI

Learning Objectives

Successfully complete this lab by achieving the following learning objectives:

Create a Server from an Amazon Linux 2 AMI

1. Navigate to EC2.
2. Click Launch Instance.
3. Select the Amazon Linux 2 AMI (HVM), SSD Volume Type 64bit (x86) AMI.
4. Select t2.micro as the instance type.
5. Select the VPC provided in the lab.
6. Select the subnet provided.
7. Select Enable for Auto-assign Public IP.
8. Click Review and Launch > Launch.
9. Select Create a new key pair.
10. Enter "confighttps" as the key pair name.
11. Click Download Key Pair.
12. Click Launch Instances > View Instances.

Install Git and Create IAM CodeCommit Credentials

1. Select the newly created instance.

2. Click Connect at the top of the screen.

3. Open a terminal window and navigate to the folder for your downloads.

4. Linux/Mac users: Execute the following command:

   chmod 400 confighttps.pem

5. Linux/Mac users: Run the example SSH command from the Connect window in the AWS Management Console in your terminal application.

   Note: If you are using Windows/PuTTY, use the link in the Connect window in the AWS Management Console that says connect using PuTTY and follow the instructions.

6. In the terminal, run the following command:

   sudo yum update -y

7. In the AWS Management Console, navigate to IAM > Users.

8. Click on cloud_user.

9. Click Add permissions > Attach existing policies directly.

10. Type "AWSCodeCommit" in the filter search box.

11. Select the AWSCodeCommitFullAccess policy.

12. Click Cancel.

    Note: We were just showing how to create this, but the permissions already exist in this lab.

13. In the terminal, run the following command to install Git:

    sudo yum install git -y

14. In the AWS Management Console, with cloud_user opened, click the Security credentials tab.

15. Navigate to the bottom of the screen, and click Generate under HTTPS Git credentials for AWS CodeCommit.

16. Click Download credentials > Close.

Create IAM User Access Key and CodeCommit Repository

1. Open the AWS Management Console tab and be sure you are still on the Security credentials tab for the cloud_user in the previous tasks.

2. Click Create access key.

3. Click Download .csv file.

   Note: The access keys will be used for the AWS Command Line Interface access in our lab. Generally, you would use an IAM role attached to the instance in production environments. The HTTPS Git credentials for AWS CodeCommit will provide access to CodeCommit.

4. Open the terminal window.

5. Configure the AWS CLI credentials:

   aws configure

6. Enter the AWS Access Key and Secret Access Key from the file downloaded in the previous step when prompted to do so.

7. Enter us-east-1 as the region and accept the Default output format.

8. Run the following command to create a CodeCommit repository from the AWS CLI:

   aws codecommit create-repository --repository-name RepoFromCLI --repository-description "My demonstration repository"

9. In the AWS Management Console, open CodeCommit and refresh the screen.

10. Click on the RepoFromCLI repository link to open it.

11. Click Add file > Upload file.

12. Click Choose file.

13. Select any small file from your machine you don’t mind uploading.

14. Enter your name as the author name and your email as the email address.

15. Click Commit changes.

16. Click Clone URL > Clone HTTPS.

17. Open up your terminal window.

18. Run the following command to clone the repository to the server:

    git clone [paste the URL from the clipboard]

19. Enter the Git credentials username from the file downloaded earlier for the username prompt.

20. Enter the Git credentials password from the file downloaded earlier for the password prompt.

21. Run the following commands:

    ls
    cd RepoFromCLI
    ls

22. Run the following command to create a local text file:

    vim test.txt

23. Hit i to enter insert mode and type the text:

    This is just a test of working with CodeCommit from the CLI

24. Hit the Escape key, type :wq!, and press Enter.

25. Add the file to Git:

    git add test.txt

26. Commit the file to the local repository:

    git commit -m "added test.txt"

27. Verify the file was committed:

    git log

28. Push the change to the CodeCommit repository:

    git push -u origin main

29. Enter the Git credentials username from the file downloaded earlier for the username prompt.

30. Enter the Git credentials password from the file downloaded earlier for the password prompt.

31. Refresh the AWS Management Console view of the CodeCommit repository for RepoFromCLI and verify the new file was uploaded.