Getting Started With Oqtane and Docker

[mikecasas]

There are two Oqtane images on Dockerhub, one is the web application and the other is the SQL Server database.

Prerequisites - assumes you have a docker environment installed. (I am using Docker Desktop on Windows)

1. Copy the docker-compose.yaml file to your machine (File is at the bottom or the gist located at https://gist.github.com/mikecasas/6937bccf48097fe37261fc81323acea0).

2. From a command line, navigate to the folder where you saved the docker-compose.yaml file.

3. Run the command docker-compose up. It will take a while for the images to download.

4. Once the containers are running, navigate in your browser to http://localhost:6001. You should see the Oqtane Installation page.

5. From the command line, run docker ps to see the running containers. Get the container id of the SQL Server container.

6. Once you have the container id, from the command line, run docker inspect to get the IP address of the SQL container.

       docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' container-id-goes-here

7. Enter the IP address of the SQL container followed by ",1433" for the port. Below is a screen shot.

• The SQL password is Password1

8. Click Install Now

docker-compose.yaml

version: "3.4"
services:
 app-oqtane:
  container_name: oqtane-app
  image: mkcsas/oqtane-app:v1
  ports:
  - "6001:6001"
 db:
  container_name: oqtane-sql
  image: mkcsas/oqtane-sql-base:v1.0.1
  ports: 
  - "1433:1433"

[markdav-is]

this is awesome @mikecasas ! I'd love to help expand this by defining the container using dockerfiles. I'm excited to see this getting closer to deployed to k8s.

[mikecasas]

Please make any and all suggestions for improvement. I have a docker compose build file too, but I just wanted to post something for people to kick the tires. I think you can fork the gist file and make any changes.

In my oqtane code, I had to hard code the port in Program.cs, so setting the port dynamically would be a good first start. I wasn't sure the best way to do that - as a .NET variable or a variable in the Dockerfile.

[PizzaConsole]

how would I set the port in my own project?

[sbwalker]

@mikecasas can you explain what you needed to change in Program.cs? It would obviously be better if we could come up with a solution where this can be configured outside the framework code.

[mikecasas]

.UseUrls("http://*:6001")

No I agree to not change the framework. I was having a tough time getting the HttpClient in Startup.cs to NOT bind to localhost:80. From my testing and reading, localhost goes out the window with containers. I'm sure this can be a variable somewhere, but I just wanted to get it working.

 // setup HttpClient for server side in a client side compatible fashion ( with auth cookie )
            if (!services.Any(x => x.ServiceType == typeof(HttpClient)))
            {
                services.AddScoped(s =>
                {
                    // creating the URI helper needs to wait until the JS Runtime is initialized, so defer it.
                    var navigationManager = s.GetRequiredService<NavigationManager>();
                    var httpContextAccessor = s.GetRequiredService<IHttpContextAccessor>();
                    var authToken = httpContextAccessor.HttpContext.Request.Cookies[".AspNetCore.Identity.Application"];
                    var client = new HttpClient(new HttpClientHandler {UseCookies = false});
                    if (authToken != null)
                    {
                        client.DefaultRequestHeaders.Add("Cookie", ".AspNetCore.Identity.Application=" + authToken);
                    }
                    client.BaseAddress = new Uri(navigationManager.Uri);
                    return client;
                });
            }

[mikecasas]

I updated the sql container on DockerHub to work with latest 2.0 release.

https://hub.docker.com/repository/docker/mkcsas/oqtane-sql

[PizzaConsole]

Thank you so much I need this!