diff --git a/README.md b/README.md index af8e5a8..9888024 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ These samples provide a starting point for how to integrate different services using a Compose file and to manage their deployment with Docker Compose. -> **Note** +> **Note** > The following samples are intended for use in local development environments such as project setups, tinkering with software stacks, etc. These samples must not be deployed in production environments. @@ -18,62 +18,66 @@ These samples provide a starting point for how to integrate different services u ## Samples of Docker Compose applications with multiple integrated services -Use with Docker Dev Environments Icon indicates Sample is compatible with [Docker Dev Environments](https://docs.docker.com/desktop/dev-environments/) +Use with Docker Dev Environments Icon indicates Sample is compatible with [Docker Dev Environments](https://docs.docker.com/desktop/dev-environments/) in Docker Desktop version 4.10 or later. -- [`ASP.NET / MS-SQL`](https://github.com/docker/awesome-compose/tree/master/aspnet-mssql) - Sample ASP.NET core application +- [`ASP.NET / MS-SQL`](aspnet-mssql) - Sample ASP.NET core application with MS SQL server database. -- [`Elasticsearch / Logstash / Kibana`](https://github.com/docker/awesome-compose/tree/master/elasticsearch-logstash-kibana) - Sample Elasticsearch, Logstash, and Kibana stack. -- [`Go / NGINX / MySQL`](https://github.com/docker/awesome-compose/tree/master/nginx-golang-mysql) - Sample Go application -with an Nginx proxy and a MySQL database. Use with Docker Dev Environments -- [`Go / NGINX / PostgreSQL`](https://github.com/docker/awesome-compose/tree/master/nginx-golang-postgres) - Sample Go -application with an Nginx proxy and a PostgreSQL database. Use with Docker Dev Environments -- [`Java Spark / MySQL`](https://github.com/docker/awesome-compose/tree/master/sparkjava-mysql) - Sample Java application and -a MySQL database. Use with Docker Dev Environments -- [`NGINX / ASP.NET / MySQL`](https://github.com/docker/awesome-compose/tree/master/nginx-aspnet-mysql) - Sample Nginx reverse proxy with an C# backend using ASP.NET Use with Docker Dev Environments -- [`NGINX / Flask / MongoDB`](https://github.com/docker/awesome-compose/tree/master/nginx-flask-mongo) - Sample Python/Flask -application with Nginx proxy and a Mongo database. Use with Docker Dev Environments -- [`NGINX / Flask / MySQL`](https://github.com/docker/awesome-compose/tree/master/nginx-flask-mysql) - Sample Python/Flask application with an Nginx proxy and a MySQL database. -- [`NGINX / Node.js / Redis`](https://github.com/docker/awesome-compose/tree/master/nginx-nodejs-redis) - Sample Node.js application with Nginx proxy and a Redis database -- [`NGINX / Go`](https://github.com/docker/awesome-compose/tree/master/nginx-golang) - Sample Nginx proxy with a Go backend. Use with Docker Dev Environments -- [`NGINX / WSGI / Flask`](https://github.com/docker/awesome-compose/tree/master/nginx-wsgi-flask) - Sample Nginx reverse proxy with a Flask backend using WSGI. -- [`PostgreSQL / pgAdmin`](https://github.com/docker/awesome-compose/tree/master/postgresql-pgadmin) - Sample setup for postgreSQL database with pgAdmin web interface -- [`Python / Flask / Redis`](https://github.com/docker/awesome-compose/tree/master/flask-redis) - Sample Python/Flask and a Redis database Use with Docker Dev Environments -- [`React / Spring / MySQL`](https://github.com/docker/awesome-compose/tree/master/react-java-mysql) - Sample React -application with a Spring backend and a MySQL database. Use with Docker Dev Environments -- [`React / Express / MySQL`](https://github.com/docker/awesome-compose/tree/master/react-express-mysql) - Sample React -application with a Node.js backend and a MySQL database. Use with Docker Dev Environments -- [`React / Express / MongoDB`](https://github.com/docker/awesome-compose/tree/master/react-express-mongodb) - Sample React -application with a Node.js backend and a Mongo database. Use with Docker Dev Environments -- [`React / Rust / PostgreSQL`](https://github.com/docker/awesome-compose/tree/master/react-rust-postgres) - Sample React -application with a Rust backend and a Postgres database. Use with Docker Dev Environments -- [`React / Nginx`](https://github.com/docker/awesome-compose/tree/master/react-nginx) - Sample React application with Nginx. Use with Docker Dev Environments -- [`Spring / PostgreSQL`](https://github.com/docker/awesome-compose/tree/master/spring-postgres) - Sample Java application -with Spring framework and a Postgres database. Use with Docker Dev Environments +- [`Elasticsearch / Logstash / Kibana`](elasticsearch-logstash-kibana) - Sample Elasticsearch, Logstash, and Kibana stack. +- [`Go / NGINX / MySQL`](nginx-golang-mysql) - Sample Go application +with an Nginx proxy and a MySQL database. Use with Docker Dev Environments +- [`Go / NGINX / PostgreSQL`](nginx-golang-postgres) - Sample Go +application with an Nginx proxy and a PostgreSQL database. Use with Docker Dev Environments +- [`Java Spark / MySQL`](sparkjava-mysql) - Sample Java application and +a MySQL database. Use with Docker Dev Environments +- [`NGINX / ASP.NET / MySQL`](nginx-aspnet-mysql) - Sample Nginx reverse proxy with an C# backend using ASP.NET Use with Docker Dev Environments +- [`NGINX / Flask / MongoDB`](nginx-flask-mongo) - Sample Python/Flask +application with Nginx proxy and a Mongo database. Use with Docker Dev Environments +- [`NGINX / Flask / MySQL`](nginx-flask-mysql) - Sample Python/Flask application with an Nginx proxy and a MySQL database. +- [`NGINX / Node.js / Redis`](nginx-nodejs-redis) - Sample Node.js application with Nginx proxy and a Redis database +- [`NGINX / Go`](nginx-golang) - Sample Nginx proxy with a Go backend. Use with Docker Dev Environments +- [`NGINX / WSGI / Flask`](nginx-wsgi-flask) - Sample Nginx reverse proxy with a Flask backend using WSGI. +- [`PostgreSQL / pgAdmin`](postgresql-pgadmin) - Sample setup for postgreSQL database with pgAdmin web interface +- [`Python / Flask / Redis`](flask-redis) - Sample Python/Flask and a Redis database Use with Docker Dev Environments +- [`React / Spring / MySQL`](react-java-mysql) - Sample React +application with a Spring backend and a MySQL database. Use with Docker Dev Environments +- [`React / Express / MySQL`](react-express-mysql) - Sample React +application with a Node.js backend and a MySQL database. Use with Docker Dev Environments +- [`React / Express / MongoDB`](react-express-mongodb) - Sample React +application with a Node.js backend and a Mongo database. Use with Docker Dev Environments +- [`React / Rust / PostgreSQL`](react-rust-postgres) - Sample React +application with a Rust backend and a Postgres database. Use with Docker Dev Environments +- [`React / Nginx`](react-nginx) - Sample React application with Nginx. Use with Docker Dev Environments +- [`Spring / PostgreSQL`](spring-postgres) - Sample Java application +with Spring framework and a Postgres database. Use with Docker Dev Environments + ## Single service samples -Use with Docker Dev Environments Icon indicates Sample is compatible with [Docker Dev Environments](https://docs.docker.com/desktop/dev-environments/) +Use with Docker Dev Environments Icon indicates Sample is compatible with [Docker Dev Environments](https://docs.docker.com/desktop/dev-environments/) in Docker Desktop version 4.10 or later. -- [`Angular`](https://github.com/docker/awesome-compose/tree/master/angular) Use with Docker Dev Environments -- [`Spark`](https://github.com/docker/awesome-compose/tree/master/sparkjava) Use with Docker Dev Environments -- [`VueJS`](https://github.com/docker/awesome-compose/tree/master/vuejs) Use with Docker Dev Environments -- [`Flask`](https://github.com/docker/awesome-compose/tree/master/flask) Use with Docker Dev Environments -- [`PHP`](https://github.com/docker/awesome-compose/tree/master/apache-php) Use with Docker Dev Environments -- [`Traefik`](https://github.com/docker/awesome-compose/tree/master/traefik-golang) Use with Docker Dev Environments -- [`Django`](https://github.com/docker/awesome-compose/tree/master/django) Use with Docker Dev Environments +- [`Angular`](angular) Use with Docker Dev Environments +- [`Spark`](sparkjava) Use with Docker Dev Environments +- [`VueJS`](vuejs) Use with Docker Dev Environments +- [`Flask`](flask) Use with Docker Dev Environments +- [`PHP`](apache-php) Use with Docker Dev Environments +- [`Traefik`](traefik-golang) Use with Docker Dev Environments +- [`Django`](django) Use with Docker Dev Environments - [`Minecraft server`](https://github.com/docker/awesome-compose/tree/master/minecraft) - [`Plex`](https://github.com/docker/awesome-compose/tree/master/plex) - [`Portainer`](https://github.com/docker/awesome-compose/tree/master/portainer) - [`Wireguard`](https://github.com/docker/awesome-compose/tree/master/wireguard) -- [`FastAPI`](https://github.com/docker/awesome-compose/tree/master/fastapi) Use with Docker Dev Environments -## Basic setups for different platforms (not production ready - useful for personal use) -- [`Gitea / PostgreSQL`](https://github.com/docker/awesome-compose/tree/master/gitea-postgres) -- [`Nextcloud / PostgreSQL`](https://github.com/docker/awesome-compose/tree/master/nextcloud-postgres) -- [`Nextcloud / Redis / MariaDB`](https://github.com/docker/awesome-compose/tree/master/nextcloud-redis-mariadb) -- [`Pi-hole / cloudflared`](https://github.com/docker/awesome-compose/tree/master/pihole-cloudflared-DoH) - Sample Pi-hole setup with use of DoH cloudflared service -- [`Prometheus / Grafana`](https://github.com/docker/awesome-compose/tree/master/prometheus-grafana) -- [`Wordpress / MySQL`](https://github.com/docker/awesome-compose/tree/master/wordpress-mysql) +- [`FastAPI`](fastapi) Use with Docker Dev Environments + +## Basic setups for different platforms (not production ready - useful for personal use) + +- [`Gitea / PostgreSQL`](gitea-postgres) +- [`Nextcloud / PostgreSQL`](nextcloud-postgres) +- [`Nextcloud / Redis / MariaDB`](nextcloud-redis-mariadb) +- [`Pi-hole / cloudflared`](pihole-cloudflared-DoH) - Sample Pi-hole setup with use of DoH cloudflared service +- [`Prometheus / Grafana`](prometheus-grafana) +- [`Wordpress / MySQL`](wordpress-mysql) + ## Getting started These instructions will get you through the bootstrap phase of creating and diff --git a/angular/README.md b/angular/README.md index b0a05a3..3121fb8 100644 --- a/angular/README.md +++ b/angular/README.md @@ -68,11 +68,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/angular) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/angular ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/apache-php/README.md b/apache-php/README.md index 908faf4..ab7de13 100644 --- a/apache-php/README.md +++ b/apache-php/README.md @@ -57,11 +57,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/apache-php) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/apache-php ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/django/README.md b/django/README.md index 16a5cc3..bd232ee 100644 --- a/django/README.md +++ b/django/README.md @@ -52,8 +52,13 @@ $ docker compose down ``` ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly the web service inside a container, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/django` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![page](../dev-envs.png) \ No newline at end of file +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/django) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/django +``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/fastapi/README.md b/fastapi/README.md index 4d20eea..682c0c7 100644 --- a/fastapi/README.md +++ b/fastapi/README.md @@ -54,11 +54,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/fastapi) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/fastapi ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/flask-redis/README.md b/flask-redis/README.md index 01e3256..d71236f 100644 --- a/flask-redis/README.md +++ b/flask-redis/README.md @@ -83,11 +83,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/flask-redis) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/flask-redis ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/flask/README.md b/flask/README.md index 36e78d5..d16ba8a 100644 --- a/flask/README.md +++ b/flask/README.md @@ -58,11 +58,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/flask) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/flask ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-aspnet-mysql/README.md b/nginx-aspnet-mysql/README.md index 503eda9..dcf7735 100644 --- a/nginx-aspnet-mysql/README.md +++ b/nginx-aspnet-mysql/README.md @@ -78,11 +78,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-aspnet-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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-aspnet-mysql ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-flask-mongo/README.md b/nginx-flask-mongo/README.md index 5838d80..ad50b10 100644 --- a/nginx-flask-mongo/README.md +++ b/nginx-flask-mongo/README.md @@ -72,11 +72,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-flask-mongo) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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-flask-mongo ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-flask-mysql/README.md b/nginx-flask-mysql/README.md index 2d21a39..0fdc450 100644 --- a/nginx-flask-mysql/README.md +++ b/nginx-flask-mysql/README.md @@ -80,11 +80,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-flask-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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-flask-mysql ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-golang-mysql/README.md b/nginx-golang-mysql/README.md index 16c403b..7160c83 100644 --- a/nginx-golang-mysql/README.md +++ b/nginx-golang-mysql/README.md @@ -93,11 +93,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-golang-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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 ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-golang-postgres/README.md b/nginx-golang-postgres/README.md index 87170bc..e40a87b 100644 --- a/nginx-golang-postgres/README.md +++ b/nginx-golang-postgres/README.md @@ -83,11 +83,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-golang-postgres) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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-postgres ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/nginx-golang/README.md b/nginx-golang/README.md index b4d0853..a49b94e 100644 --- a/nginx-golang/README.md +++ b/nginx-golang/README.md @@ -86,11 +86,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/nginx-golang) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -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 ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/open_in_new.svg b/open_in_new.svg new file mode 100644 index 0000000..112ff73 --- /dev/null +++ b/open_in_new.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/react-express-mongodb/README.md b/react-express-mongodb/README.md index 2f896e7..7af1da2 100644 --- a/react-express-mongodb/README.md +++ b/react-express-mongodb/README.md @@ -135,11 +135,13 @@ __Explanation of service mongo__ ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/react-express-mongodb) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/react-express-mongodb ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/react-express-mysql/README.md b/react-express-mysql/README.md index 2f87ab2..8550b7b 100644 --- a/react-express-mysql/README.md +++ b/react-express-mysql/README.md @@ -100,11 +100,13 @@ Removing network react-express-mysql_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/react-express-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/react-express-mysql ``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/react-java-mysql/README.md b/react-java-mysql/README.md index 741166a..85d4b47 100644 --- a/react-java-mysql/README.md +++ b/react-java-mysql/README.md @@ -35,12 +35,12 @@ services: ... ``` The compose file defines an application with three services `frontend`, `backend` and `db`. -When deploying the application, docker compose maps port 3000 of the frontend service container to port 3000 of the host as specified in the file. +When deploying the application, docker compose maps port 3000 of the frontend service container to port 3000 of the host as specified in the file. Make sure port 3000 on the host is not already being in use. -> ℹ️ **_INFO_** -> 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 +> ℹ️ **_INFO_** +> 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 > `#image: mysql:8.0.27` ## Deploy with docker compose @@ -86,8 +86,13 @@ Removing network react-java-mysql_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly frontend or the backend services inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/react-java-mysql` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![page](../dev-envs.png) \ No newline at end of file +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/react-java-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/react-java-mysql +``` + +![page](../dev-envs.png) diff --git a/react-nginx/README.md b/react-nginx/README.md index 784687d..5d27659 100755 --- a/react-nginx/README.md +++ b/react-nginx/README.md @@ -89,11 +89,13 @@ Removing network react-nginx_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/react-nginx) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. -To develop directly on the services inside containers, use the HTTPS Git url of the sample: ``` https://github.com/docker/awesome-compose/tree/master/react-nginx -``` \ No newline at end of file +``` + +![Screenshot of creating a Dev Environment in Docker Desktop](../dev-envs.png) diff --git a/react-rust-postgres/readme.md b/react-rust-postgres/readme.md index de63685..b7900cb 100644 --- a/react-rust-postgres/readme.md +++ b/react-rust-postgres/readme.md @@ -77,8 +77,13 @@ Removing network react-rust-postgres_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly frontend or the backend services inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/react-rust-postgres` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. + +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/react-rust-postgres) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/react-rust-postgres +``` ![page](../dev-envs.png) diff --git a/sparkjava-mysql/README.md b/sparkjava-mysql/README.md index 1957049..aca4803 100644 --- a/sparkjava-mysql/README.md +++ b/sparkjava-mysql/README.md @@ -78,8 +78,13 @@ Removing network sparkjava-mysql_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly frontend or the backend services inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/sparkjava-mysql` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. -![page](../dev-envs.png) \ No newline at end of file +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/sparkjava-mysql) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/sparkjava-mysql +``` + +![page](../dev-envs.png) diff --git a/sparkjava/README.md b/sparkjava/README.md index a448233..7fe66a9 100644 --- a/sparkjava/README.md +++ b/sparkjava/README.md @@ -62,8 +62,13 @@ Removing network sparkjava_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly sparkjava service inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/sparkjava` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. + +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/sparkjava) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/sparkjava +``` ![page](../dev-envs.png) diff --git a/spring-postgres/README.md b/spring-postgres/README.md index e5b47d1..943fce4 100644 --- a/spring-postgres/README.md +++ b/spring-postgres/README.md @@ -80,8 +80,13 @@ Removing network spring-postgres_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly frontend or the backend services inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/spring-postgres` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. + +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/spring-postgres) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/spring-postgres +``` ![page](../dev-envs.png) diff --git a/traefik-golang/README.md b/traefik-golang/README.md index 55f20d1..7237ca9 100644 --- a/traefik-golang/README.md +++ b/traefik-golang/README.md @@ -95,8 +95,13 @@ $ docker compose down ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly the backend service inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/traefik-golang` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. + +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/traefik-golang) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/traefik-golang +``` ![page](../dev-envs.png) diff --git a/vuejs/README.md b/vuejs/README.md index fc4782e..520be79 100644 --- a/vuejs/README.md +++ b/vuejs/README.md @@ -62,8 +62,13 @@ Removing network vuejs_default ## Use with Docker Development Environments -You can use this sample with the Dev Environments feature of Docker Desktop. -To develop directly web service inside containers, you just need to use the https git url of the sample: -`https://github.com/docker/awesome-compose/tree/master/vuejs` +You can use this sample with the Dev Environments feature of Docker Desktop version 4.10 or later. + +* [Open in Docker Dev Environments Open in Docker Dev Environments](https://open.docker.com/dashboard/dev-envs?url=https://github.com/docker/awesome-compose/tree/master/vuejs) (works in Docker Desktop 4.12 and later versions) +* In the "Create a Dev Environment" wizard, choose "Existing Git Repo", copy the URL below and paste into the Git Repository field. + +``` +https://github.com/docker/awesome-compose/tree/master/vuejs +``` ![page](../dev-envs.png)