Updated docker-compose and readme

Author: GodOfAllBeings

Dockerfile

@@ -4,7 +4,7 @@ FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
 
 WORKDIR /app
 
-#EXPOSE 4000
+EXPOSE 4000
 EXPOSE 4001
 ENV ASPNETCORE_URLS=https://*:4000
 FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build

Program.cs

@@ -65,7 +65,7 @@ public static void Main(string[] args)
                 app.UseSwaggerUI();
             }
 
-            //app.UseHttpsRedirection();
+            app.UseHttpsRedirection();
 
             app.UseAuthorization();
             //ResourceConnector.GetGraphForResource("08ac06ea-4005-4e31-ae69-7ffc0447b332");

README.md

@@ -1,9 +1,69 @@
 # Repository
 
 ## Docker
-This project supports docker runtime environment.
+This project supports docker runtime environment, for which you will need to download docker from here: https://www.docker.com/products/docker-desktop/.
 
-To build the docker image run, download docker from https://www.docker.com/products/docker-desktop/. 
+For this project, be aware that express listens on a specfic port (can be found in /API/Endpoints), which must be the same port that is used in the docker file. 
+
+Open a terminal and navigate to the root of the project.
+
+## Docker network
+
+If you run other services like a repository or service registry through docker locally, you will also need to setup a network. This creates a connection between local docker containers which is essential for establishing a connection.
+
+If you want to run the project(s) with docker compose, the network needs to be created before running the compose file.
+
+To create a docker network run below the commands below in a terminal:
+
+```
+docker network create -d bridge data
+```
+
+## Docker Compose
+It is recommended to use this approach to run the application. To run this project using docker-compose you need to follow the steps below:
+
+Build the docker image:
+```
+docker-compose build
+```
+Run the docker image:
+```
+docker-compose up
+```
+Stop the docker image:
+```
+docker-compose down
+```
+
+## Dockerfile
+Alternatively you can build the image directly from the Dockerfile by running the following commands from the root of the project:
+
+```
+docker build -t Repository .
+docker run -d -p 4001:4001 -p 4000:4000 --name Repository dockerrepository:latest
+```
+
+When running in docker, localhost and 127.0.0.1 will resolve to the container. If you want to access the outside host (e.g. your machine), you can add an entry to the container's /etc/hosts file. You can read more details on this here: https://www.howtogeek.com/devops/how-to-connect-to-localhost-within-a-docker-container/
+This will make localhost available as your destination when requesting from your host-unit e.g. from postman or the browser, not between containers.
+
+To access the outside host, write the following docker run command instead of the one written above:
+```
+docker run -d -p 4001:4001 -p 4000:4000 --add-host host.docker.internal:host-gateway --name Repository dockerrepository:latest
+```
+
+Here the value "host.docker.internal" maps to the container's host gateway, which matches the real localhost value. This name can be replaced with your own string.
+
+To establish connections between containers, add a reference to the network by adding the below to your docker run:
+
+```
+--network=data
+```
+
+The full run command we recommend for local development:
+
+```
+docker run -d -p 4001:4001 -p 4000:4000 --add-host host.docker.internal:host-gateway --network=data --name Repository dockerrepository:latest
+```
 
 To establish a secure connection on a development environment, a certificate is necessary. Run the follow commands. 
 

docker-compose.yaml

@@ -1,18 +1,17 @@
 version: "3.7"
 
 services:
-  Reposistory:
+  reposistory:
+    container_name: reposistory
     image: dockerrepository:latest
     build: .
-    #dockerfile: ./Dockerfile
     ports:
       - "4000:4000"
       - "4001:4001"
     environment:
       - ASPNETCORE_ENVIRONMENT=Development
-      - ASPNETCORE_URLS="https://+;http://+"
-      - ASPNETCORE_HTTPS_PORT=4000 
-      - ASPNETCORE_Kestrel__Certificates__Default__Password=1234
-      - ASPNETCORE_Kestrel__Certificates__Default__Path=/https/Repository.pfx
-    volumes:
-      -  ~/.aspnet/https:/https:ro
+      - ASPNETCORE_URLS="http://+"
+    networks:
+      - data
+    extra_hosts:
+      - "localhost:host-gateway"