hello-rust

A simple, containerized Rust web server for Hello World test server designed for deployment on Google Cloud Run.

Project Overview

hello-rust is a basic "Hello, World!" web server prints Hello World written in Rust, designed to be deployed as a containerized application on Google Cloud Run.

Key Technologies

• Language: Rust
• Web Framework: Hyper
• Containerization: Docker
• Deployment: Google Cloud Run
• CI/CD: Google Cloud Build

Getting Started

This project uses a Makefile to simplify common development tasks.

Prerequisites

• Rust Toolchain
• Docker
• Google Cloud SDK

Initial Setup

1. Install Dependencies:

   cargo build
   

2. Run the application locally:

   make run
   

   The server will start on port 8080.

Development Workflow

The Makefile provides targets for common development tasks.

Building the Project

• Development Build:

  make build
  

• Release Build:

  make release
  

Running Locally

make run

Code Quality

• Formatting:

  make format
  

• Linting:

  make clippy
  

Testing

make test

Deployment

Deployment is handled by Google Cloud Build and defined in cloudbuild.yaml.

Manual Deployment

To manually trigger a deployment, run:

make deploy

This command submits a build to Google Cloud Build, which will:

1. Build the Docker image (as defined in Dockerfile).
2. Push the image to Google Container Registry (GCR).
3. Deploy the new image to the cloudrun-rust service in the us-central1 region.

Deployment Process

• Dockerfile: A multi-stage Dockerfile is used to create a minimal, secure production image.
  1. Builder Stage: The Rust code is compiled in a rust builder image.
  2. Final Stage: The compiled binary is copied to a minimal gcr.io/distroless/cc-debian12 image.
• cloudbuild.yaml: This file defines the Cloud Build pipeline. It takes care of building, pushing, and deploying the container image.