adelorenzo/awesome-compose
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

nginx-golang-mysql: update README

Browse Source 
Signed-off-by: Milas Bowman <milas.bowman@docker.com>
This commit is contained in:
Milas Bowman 2022-07-11 15:56:04 -04:00
parent f122b52ce6
commit aa997c70ea
1 changed files with 37 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
nginx-golang-mysql/README.md
View File

@ -1,5 +1,5 @@
## Compose sample application ## Compose sample application
### Go server with an Nginx proxy and a MySQL database ### Go server with an Nginx proxy and a MariaDB/MySQL database
Project structure: Project structure:
``` ```
@ -7,30 +7,37 @@ Project structure:
├── backend ├── backend
│   ├── Dockerfile │   ├── Dockerfile
│   ├── go.mod │   ├── go.mod
│   ├── go.sum
│   └── main.go │   └── main.go
├── db ├── db
│   └── password.txt │   └── password.txt
├── compose.yaml
├── proxy ├── proxy
│   ├── conf │   └── nginx.conf
│   └── Dockerfile ├── compose.yaml
└── README.md └── README.md
``` ```
[_compose.yaml_](compose.yaml) [_compose.yaml_](compose.yaml)
``` ```yaml
services: services:
backend: backend:
build: backend build:
context: backend
target: builder
... ...
db: db:
# We use a mariadb image which supports both amd64 & arm64 architecture # We use a mariadb image which supports both amd64 & arm64 architecture
image: mariadb:10.6.4-focal image: mariadb:10-focal
# If you really want to use MySQL, uncomment the following line # If you really want to use MySQL, uncomment the following line
#image: mysql:8.0.27 #image: mysql:8
... ...
proxy: proxy:
build: proxy image: nginx
volumes:
- type: bind
source: ./proxy/nginx.conf
target: /etc/nginx/conf.d/default.conf
read_only: true
ports: ports:
- 80:80 - 80:80
... ...
@ -42,11 +49,11 @@ Make sure port 80 on the host is not already being in use.
> ℹ️ **_INFO_** > ℹ️ **_INFO_**
> For compatibility purpose between `AMD64` and `ARM64` architecture, we use a MariaDB as database instead of MySQL. > For compatibility purpose between `AMD64` and `ARM64` architecture, we use a MariaDB as database instead of MySQL.
> You still can use the MySQL image by uncommenting the following line in the Compose file > You still can use the MySQL image by uncommenting the following line in the Compose file
> `#image: mysql:8.0.27` > `#image: mysql:8`
## Deploy with docker compose ## Deploy with docker compose
``` ```shell
$ docker compose up -d $ docker compose up -d
Creating network "nginx-golang-mysql_default" with the default driver Creating network "nginx-golang-mysql_default" with the default driver
Building backend Building backend
@ -64,24 +71,33 @@ Creating nginx-golang-mysql_proxy_1 ... done
## Expected result ## Expected result
Listing containers must show three containers running and the port mapping as below: Listing containers must show three containers running and the port mapping as below:
``` ```shell
$ docker ps $ docker compose ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES NAME COMMAND SERVICE STATUS PORTS
8906b14c5ad1 nginx-golang-mysql_proxy "nginx -g 'daemon of…" 2 minutes ago Up 2 minutes 0.0.0.0:80->80/tcp nginx-golang-mysq nginx-golang-mysql-backend-1 "/code/bin/backend" backend running
l_proxy_1 nginx-golang-mysql-db-1 "docker-entrypoint.s…" db running (healthy) 3306/tcp
13e0e0a7715a nginx-golang-mysql_backend "/server" 2 minutes ago Up 2 minutes 8000/tcp nginx-golang-mysq nginx-golang-mysql-proxy-1 "/docker-entrypoint.…" proxy running 0.0.0.0:80->80/tcp
l_backend_1
ca8c5975d205 mysql:5.7 "docker-entrypoint.s…" 2 minutes ago Up 2 minutes 3306/tcp, 33060/tcp nginx-golang-mysq
l_db_1 l_db_1
``` ```
After the application starts, navigate to `http://localhost:80` in your web browser or run: After the application starts, navigate to `http://localhost:80` in your web browser or run:
``` ```shell
$ curl localhost:80 $ curl localhost:80
["Blog post #0","Blog post #1","Blog post #2","Blog post #3","Blog post #4"] ["Blog post #0","Blog post #1","Blog post #2","Blog post #3","Blog post #4"]
``` ```
Stop and remove the containers Stop and remove the containers
``` ```shell
$ docker compose down $ docker compose down
``` ```
## Use with Docker Development Environments
You can use this sample with the Dev Environments feature of Docker Desktop.
![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png)
To develop directly on the services inside containers, use the HTTPS Git url of the sample:
```
https://github.com/docker/awesome-compose/tree/master/nginx-golang-mysql
```