https://github.com/dockersamples/build-cloud-cookbook
https://github.com/dockersamples/build-cloud-cookbook
Last synced: 8 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/dockersamples/build-cloud-cookbook
- Owner: dockersamples
- License: apache-2.0
- Created: 2024-04-18T15:03:34.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-04T16:28:54.000Z (about 1 year ago)
- Last Synced: 2025-04-05T20:35:19.440Z (about 1 year ago)
- Language: Rust
- Size: 30.3 KB
- Stars: 5
- Watchers: 3
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Build Cloud Cookbook
This repository contains a sample application that demonstrates building a simple Rust web server using Docker Build Cloud. This app is part of a Docker guide showcasing how to leverage Docker Build Cloud for building containerized applications.
## Project Structure
- **src/** - The main application code for the Rust web server.
- **Dockerfile** - Defines how the Rust app is built and containerized using Docker Build Cloud.
- **build-and-run.sh** - A script that builds and runs the application for local development.
- **.dockerignore** - Specifies files to be ignored when building the Docker image.
- **.github/** - Contains GitHub workflows for CI/CD, including Docker Build Cloud integration.
## Setup Instructions
Follow these steps to get the project up and running locally:
### 1. Clone the repository
```bash
git clone https://github.com/dockersamples/build-cloud-cookbook.git
```
### 2. Navigate to the project directory:
```bash
cd build-cloud-cookbook
```
### 3. Build and run the application
You can use the provided build-and-run.sh script to build and run the application. This script handles the Docker Build Cloud process and starts the web server on the default address `127.0.0.1:3000`.
```bash
./build-and-run.sh
```
The app will be accessible at `http://127.0.0.1:3000`.
## Configuration
This project uses the following environment variable for configuration:
`BIND_ADDR` - The address and port on which the web server will bind (default: `127.0.0.1:3000`).
To override the default value, create a .env file at the root of the project:
Example .env file:
```makefile
BIND_ADDR=0.0.0.0:8080
```
## Backlinks
For more information on Docker Build Cloud and how this sample app was built, check out the [Docker Build Cloud documentation](https://docs.docker.com/build-cloud/).
## Maintenance Schedule
This repository is maintained quarterly. Security updates and bug fixes are applied as needed, but expect up to a two-week delay for non-critical updates.
## License
This project is licensed under the Apache 2.0 License.
## Contributing
Contributions are welcome for bug fixes and security issues. For feature requests or improvements, feel free to open an issue, but note that major changes may not be prioritized as this repository supports a specific Docker guide.