Docker Dot Net Notes

Table of Contents

1. Publish to Docker Repository
- 1.1. Initial Setup
- 1.2. Publish
2. Updates
- 2.1. Code
- 2.2. Docker
3. Troubleshooting
- 3.1. Web Sites
  - 3.1.1. Rendering Issues

1. Publish to Docker Repository

1.1. Initial Setup

1.1.1. Don’t do this

Do not add Docker Support to the project!
It is not necessary and doesn’t work properly anyway.

1.1.2. Create a Publishing Profile

Right mouse click on the Project and select the Publish… menu item.
Click the Add a publish profile link.
Select the Docker Container Registry Target and click Next.
Select the Other Docker Container Registry Target and click Next.
Set Target Registry URL=
```
https://docker.repo.xackleystudio.com
```
Provide credentials and click Next
Select .NET SDK for Container build and click Finish
Click Close

1.1.3. Create a Docker Compose File

Create a docker compose.yml file like the following:

version: '3.5'
services:

  kestrel-my-site:
    container_name: My-Site
    image: 'docker.repo.xackleystudio.com/my-docker-image:latest'
    ports:
      - '8932:80'
    environment:
      - TZ=America/New_York
      - PUID=1000
      - PGID=1000
    volumes:
      - ./My-Site-data/logs:/app/logs
    restart: unless-stopped

1.2. Publish

After the Publishing Profile has been created, click the Publish button to publish.

2. Updates

2.1. Code

Update and test code as per usual.
Publish via the already created profile.

2.2. Docker

Over on the Docker host server, update the image via:
```
sudo docker-compose pull
```
Now restart the container via:
```
sudo docker-compose up -d
```
You can optionally remove older images via:
```
sudo docker image prune -a
```

3. Troubleshooting

3.1. Web Sites

3.1.1. Rendering Issues

If the site fails to render it may be missing the .js file.