# sample-http-app

**Repository Path**: mirrors_cloudfoundry/sample-http-app

## Basic Information

- **Project Name**: sample-http-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sample HTTP Application

The sample HTTP application implements the correct shutdown behavior for an HTTP application deployed to Cloud Foundry. It adheres to the following contract when shutting down:

- App receives termination signal
- App closes listener so that it stops accepting new connections
- App finishes serving in-flight requests
- App closes existing connections as their requests complete
- App shuts down (or is KILLed)

This application implements the connection management itself in [main.go](main.go), but similar logic can be found in the [Shutdown method of the Golang HTTP server](https://golang.org/src/net/http/server.go?s=78921:78975#L2552).


## Configure

The app is configurable by setting the following environment variables:

- `PORT`: The port on which the HTTP server will be listening. It defaults to `8080`.

## Response Latency

The response latency can be controlled by setting the query parameter `wait` to any string parseable by [time.ParseDuration](https://golang.org/pkg/time/#ParseDuration). The default value is `10 µs`.

## Deploy to Cloud Foundry

Simply run `cf push` from the app root directory and it should deploy successfully.

## Run Locally

To run locally, follow the steps below:

```
go get ./...
go build .
./sample-http-app
```

To run the tests, first get the dependencies using `go get -t ./... && go get github.com/onsi/ginkgo/ginkgo` then run `ginkgo` in the app root directory.