> ## 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.
# Setup Cloud9 IDE
> Guide to provisioning an AWS Cloud9 IDE, cloning a CodeCommit repository, inspecting a Flask app, and preparing to containerize it with Docker
Welcome back. In this lesson you'll provision an AWS Cloud9 IDE and prepare a development workspace for the sample application used throughout this course. Follow the steps below to create the environment, inspect the repository, and run the initial app files.
1. Open the AWS Management Console and search for Cloud9. Select the Cloud9 service. If you use Cloud9 frequently, bookmark it — bookmarked services appear in the left panel.
2. Create a new Cloud9 environment:
* Click "Create environment".
* Provide a name (this lesson uses `CodingGround`) and an optional description.
* Leave other settings at their defaults unless you have specific instance size or networking requirements.
Cloud9 will provision the required backend resources (it creates and configures an EC2 instance for your IDE). Provisioning typically takes 5–10 minutes. When the environment is ready, click "Open" to launch the Cloud9 editor in a new tab and wait for the IDE to initialize and connect.
Cloud9 uses an EC2 instance billed to your account. If you want to avoid ongoing charges, stop or terminate the instance when not in use.
Once connected, the Cloud9 interface provides a complete development workspace: the file tree is on the left, the editor in the center, and an integrated terminal at the bottom.
For example, opening the repository `README.md` displays the file in the editor while leaving the terminal available for commands.
Next: clone the course repository from AWS CodeCommit into your Cloud9 environment.
4. In the AWS Console, open CodeCommit and copy the repository’s HTTPS clone URL.
Important: Your Cloud9 EC2 instance must be able to authenticate to CodeCommit. If you see authentication errors while cloning, ensure either:
* The Cloud9 EC2 instance has an IAM role attached with the necessary CodeCommit permissions, or
* You have configured the AWS CLI credential helper / Git credentials for CodeCommit on the instance.
Now switch to the Cloud9 terminal and run the clone command. Example output:
```bash theme={null}
ec2-user:~/environment $ git clone https://git-codecommit.eu-central-1.amazonaws.com/v1/repos/aws-microservice-project
Cloning into 'aws-microservice-project'...
remote: Counting objects: 24, done.
Unpacking objects: 100% (24/24), 10.94 MiB | 15.82 MiB/s, done.
ec2-user:~/environment $
```
After cloning, a new folder `aws-microservice-project` appears in the Cloud9 file tree. Expand it to inspect project files. Typical top-level files and folders include:
| File / Folder | Purpose |
| ------------- | --------------------------------------------------- |
| `app.py` | Main Flask application entry point. |
| `templates/` | HTML templates (e.g. `login.html`, `product.html`). |
| `static/` | Static assets like CSS and images. |
| `README.md` | Project overview and setup instructions. |
Below is an excerpt from `app.py` to show the basic Flask structure and where the database client will be integrated later:
```python theme={null}
from flask import Flask, render_template, request, redirect, url_for
import psycopg2 # Will be used later for PostgreSQL connections
app = Flask(__name__)
# Default credentials
DEFAULT_USERNAME = "admin"
DEFAULT_PASSWORD = "password123"
@app.route('/', methods=['GET', 'POST'])
def login():
error = None
if request.method == 'POST':
username = request.form['username']
password = request.form['password']
# Check if provided credentials match the default ones
if username == DEFAULT_USERNAME and password == DEFAULT_PASSWORD:
return redirect(url_for('welcome'))
else:
error = 'Invalid Credentials. Please try again.'
return render_template('login.html', error=error)
@app.route('/welcome')
def welcome():
return render_template('product.html')
@app.route('/place_order')
def place_order():
product_id = request.args.get('product')
return render_template('place_order.html', product_id=product_id)
@app.route('/submit_order', methods=['POST'])
def submit_order():
# Code to handle order submission will be added later
pass
```
If you prefer to work locally instead of in Cloud9, cloning CodeCommit on your machine requires proper authentication (CodeCommit credential helper or SSH keys). For more details, see AWS CodeCommit documentation:
* [AWS Cloud9 User Guide](https://docs.aws.amazon.com/cloud9/latest/user-guide/welcome.html)
* [AWS CodeCommit HTTPS connections and Git credentials](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-git-remote-codecommit.html)
Next steps
* Create a `Dockerfile` in the repository root to containerize the Flask app.
* Build and run the container locally inside Cloud9 to validate the app before deploying to AWS services.
That’s it for this lesson. In the next lesson we will add a Dockerfile and prepare the application for container-based deployment. See you there.