Updated to use Go 1.11.2. Fixed ENTRYPOINT and CMD in Dockerfile. Cleaned up README.

pull/15/head
Jeromy Streets 6 years ago
parent 82e1401142
commit 5e22c7de4c
  1. 4
      .dockerignore
  2. 5
      Dockerfile
  3. 48
      README.md
  4. 2
      cli/version/version.go

@ -0,0 +1,4 @@
.gitignore
Dockerfile
LICENSE
README.md

@ -1,4 +1,4 @@
FROM golang:1.11.1 as builder FROM golang:1.11.2 as builder
EXPOSE 8080 EXPOSE 8080
@ -20,4 +20,5 @@ RUN CGO_ENABLED=0 go build -a -installsuffix cgo -o /serve ${MAIN}
FROM scratch FROM scratch
COPY --from=builder /serve / COPY --from=builder /serve /
CMD ["/serve"] ENTRYPOINT ["/serve"]
CMD []

@ -1,15 +1,21 @@
# static-file-server # static-file-server
Tiny, simple static file server using environment variables for configuration ## Introduction
Tiny, simple static file server using environment variables for configuration.
Install from any of the following locations:
Available on Docker Hub at https://hub.docker.com/r/halverneus/static-file-server/ - Docker Hub: https://hub.docker.com/r/halverneus/static-file-server/
Available on GitHub at https://github.com/halverneus/static-file-server - GitHub: https://github.com/halverneus/static-file-server
Environment variables with defaults: ## Configuration
### Environment Variables
Default values are shown with the associated environment variable.
```bash ```bash
# Enable debugging for troubleshooting. If set to 'true' this prints extra # Enable debugging for troubleshooting. If set to 'true' this prints extra
# information during execution. Default value is 'false'. # information during execution.
DEBUG=false DEBUG=false
# Optional Hostname for binding. Leave black to accept any incoming HTTP request # Optional Hostname for binding. Leave black to accept any incoming HTTP request
# on the prescribed port. # on the prescribed port.
@ -31,10 +37,12 @@ TLS_CERT=
TLS_KEY= TLS_KEY=
``` ```
Matching configuration YAML settings. YAML settings are individually overridden ### YAML Configuration File
by the corresponding environment variable. The following is an example
configuration file with defaults. Pass in the path to the configuration file YAML settings are individually overridden by the corresponding environment
using the command line option ('-c', '-config', '--config'). variable. The following is an example configuration file with defaults. Pass in
the path to the configuration file using the command line option
('-c', '-config', '--config').
```yaml ```yaml
debug: false debug: false
@ -47,7 +55,9 @@ tls-cert: ""
tls-key: "" tls-key: ""
``` ```
## Without Docker ## Deployment
### Without Docker
```bash ```bash
PORT=8888 FOLDER=. ./serve PORT=8888 FOLDER=. ./serve
@ -55,10 +65,13 @@ PORT=8888 FOLDER=. ./serve
Files can then be accessed by going to http://localhost:8888/my/file.txt Files can then be accessed by going to http://localhost:8888/my/file.txt
## With Docker ### With Docker
```bash ```bash
docker run -d -v /my/folder:/web -p 8080:8080 halverneus/static-file-server:latest docker run -d \
-v /my/folder:/web \
-p 8080:8080 \
halverneus/static-file-server:latest
``` ```
This will serve the folder "/my/folder" over http://localhost:8080/my/file.txt This will serve the folder "/my/folder" over http://localhost:8080/my/file.txt
@ -66,15 +79,18 @@ This will serve the folder "/my/folder" over http://localhost:8080/my/file.txt
Any of the variables can also be modified: Any of the variables can also be modified:
```bash ```bash
docker run -d -v /home/me/dev/source:/content/html -v /home/me/dev/files:/content/more/files -e FOLDER=/content -p 8080:8080 halverneus/static-file-server:latest docker run -d \
-v /home/me/dev/source:/content/html \
-v /home/me/dev/files:/content/more/files \
-e FOLDER=/content \
-p 8080:8080 \
halverneus/static-file-server:latest
``` ```
## Also try... ### Getting Help
```bash ```bash
./serve help ./serve help
# OR # OR
docker run -it halverneus/static-file-server:latest help docker run -it halverneus/static-file-server:latest help
``` ```
This maybe a cheesy program, but it is convenient and less than 6MB in size.

@ -19,7 +19,7 @@ var (
MinorVersion = 4 MinorVersion = 4
// FixVersion of static-file-server. // FixVersion of static-file-server.
FixVersion = 0 FixVersion = 1
// Text for directly accessing the static-file-server version. // Text for directly accessing the static-file-server version.
Text = fmt.Sprintf( Text = fmt.Sprintf(

Loading…
Cancel
Save