> ## Documentation Index
> Fetch the complete documentation index at: https://docs.briankimemia.is-a.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# AWS Docker and Elastic Beanstalk Deployment Guide
# AWS Docker and Elastic Beanstalk Deployment Guide
Welcome to this comprehensive guide on deploying a containerized application using Docker and AWS Elastic Beanstalk! π Let's dive in and explore each step in detail.
## Table of Contents
* [Install Docker](#install-docker)
* [Build Your Custom Image](#build-your-custom-image)
* [Deploy to Elastic Beanstalk](#deploy-to-elastic-beanstalk)
* [Delete Resources](#delete-resources)
***
## Install Docker
### Step 1: Install Docker Desktop
π‘ **What is Docker Desktop?**
Docker Desktop is a user-friendly tool for managing Docker containers. It simplifies the process of building, testing, and deploying applications.
* **Download Docker Desktop** from the [official website](https://www.docker.com/products/docker-desktop).
* **Install Docker Desktop** on your machine.
* **Verify Installation** by running `docker --version` in the terminal.
π Ensure Docker is correctly installed and configured to avoid issues later.
### Step 2: Run a Pre-Built Container Image
* **Run Nginx Container**:
```bash theme={null}
docker run -d -p 80:80 nginx
```
* Access the Nginx Welcome Page at [http://localhost](http://localhost).
π‘ **What is Nginx?**
Nginx is a high-performance web server used to serve web content. It's commonly used in containerized environments.
***
## Build Your Custom Image
### Step 1: Create a Dockerfile
Create a `Dockerfile` with the following content:
```dockerfile theme={null}
FROM nginx:latest
COPY index.html /usr/share/nginx/html/
EXPOSE 80
```
π‘ **Understanding Dockerfile Instructions**
* `FROM nginx:latest` uses the latest Nginx image as a base.
* `COPY index.html /usr/share/nginx/html/` replaces the default Nginx HTML file.
* `EXPOSE 80` makes port 80 available for connections.
### Step 2: Create Your HTML Content
Create `index.html`:
```html theme={null}
My Web App
Hello from YOURNAME's custom Docker image!
```
π‘ **Customize Your Webpage**
Replace `YOURNAME` with your name to personalize the message.
### Step 3: Build Your Docker Image
Build the Docker Image:
```bash theme={null}
docker build -t my-web-app .
```
π Ensure all files are in the correct directory and the Dockerfile is properly configured.
### Step 4: Run Your Custom Image
Run the Custom Image:
```bash theme={null}
docker run -d -p 80:80 my-web-app
```
Verify Deployment by accessing [http://localhost](http://localhost) in your browser.
β οΈ **Port Conflicts**
Ensure no other services are using port 80 to avoid conflicts.
***
## Deploy to Elastic Beanstalk
### Step 1: Set Up Elastic Beanstalk
Create an Elastic Beanstalk Application:
* Navigate to the Elastic Beanstalk console.
* Choose **Create Application** and follow the prompts.
* Select **Docker** as the platform.
π‘ **What is Elastic Beanstalk?**
Elastic Beanstalk simplifies the deployment of applications by managing the underlying infrastructure.
### Step 2: Upload Your Application Code
Prepare Your Application:
* Create a ZIP file containing your `Dockerfile` and `index.html`.
* Upload the ZIP File in Elastic Beanstalk.
π Ensure files are at the root level of the ZIP to avoid deployment issues.
### Step 3: Configure and Deploy
Configure Environment Settings:
* Set the environment type to **Single Instance**.
* Ensure the correct platform version and branch are selected.
* Deploy your application and access it via the provided domain link.
β οΈ **Resource Costs**
Remember to terminate environments and delete resources when they are no longer needed to avoid unnecessary costs.
***
## Delete Resources
### Step 1: Terminate Elastic Beanstalk Environment
* Navigate to your environment in the Elastic Beanstalk console.
* Select **Terminate Environment** and confirm the action.
π‘ **Cleanup is Crucial**
Properly deleting resources ensures you don't incur unexpected charges.
### Step 2: Remove Docker Containers
List all containers:
```bash theme={null}
docker ps -a
```
Stop and remove containers:
```bash theme={null}
docker stop
docker rm
```
π Replace `` with the actual ID of your container.
### Step 3: Delete S3 Buckets
* Navigate to the S3 Console.
* Delete buckets associated with your Elastic Beanstalk application.
β οΈ **Bucket Deletion**
Ensure you have the necessary permissions and confirm deletions to prevent data loss.
***
## Conclusion
Congrats! You've successfully deployed a containerized application to AWS Elastic Beanstalk. Remember to clean up resources to manage costs and maintain security best practices. Happy coding! π
## π§ Contact
For questions or feedback, reach out:
π¨ Email: [projects@briankimemia.is-a.dev](mailto:projects@briankimemia.is-a.dev)
π Portfolio: [Brian Kimemia](https://briankimemia.is-a.dev/)
**GitHub:** [BrianKN019](https://github.com/BrianKN019)
***
**Thank you for exploring this project! Letβs innovate and build secure AWS solutions together. π**