Skip to content

Commit

Permalink
adds details to connect with MSSQL Server Studio
Browse files Browse the repository at this point in the history
  • Loading branch information
LFLaverty committed Nov 23, 2023
1 parent c26698d commit f8e1e7c
Show file tree
Hide file tree
Showing 4 changed files with 39 additions and 7 deletions.
46 changes: 39 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,8 @@ volumes:
- Configures the directory `/publish/wwwroot/media` inside of the container to use a docker volume named `umbraco_media`
- Sets up a volume for `umbraco_media`

### Running `docker-compose` commands

Run the command `docker-compose up`. This will successfully launch an Umbraco site with the message **Boot Failed**... But at least we know the code runs.

![Alt text](readmefiles/docker-boot-failed.png)
Expand All @@ -248,6 +250,16 @@ You'll also have a volume named `time-in-umbraco-docker_umbraco-media`.
![Alt text](readmefiles/docker-volume.png)


### Undoing `docker-compose` commands

*Note* that you can reverse the `docker-compose up` command at any time by running:

- `docker-compose down --rmi local --volumes` to remove all docker artifacts, and data volumes
- `docker-compose down --rmi local` to remove all docker artifacts, but leave data

This will remove any docker-compose generated components (including your media and data). It's a good idea to clear down the data & volumes while debugging your Docker setup.


### Why isn't the site running?

We can inspect the log files to find out why the site isn't running. In docker desktop, select *Containers*, then select *Umbraco_Website-1*, click *Files*, then scroll down the list to the application directory `./publish/umbraco/Logs/UmbracoTraceLog.[datetime].json`. Right click the file and select *Edit* to quickly inspect the file.
Expand Down Expand Up @@ -510,25 +522,45 @@ The full list of environment variables you can pass to MSSQL Server in the `envi

Run `docker-compose down --rmi local --volumes` to remove the broken Umbraco site, then run `docker-compose up`. After a minute or so, your Docker Desktop will include two services, an Umbraco Website, and a SQL database:

![Alt text](image.png)
![Alt text](readmefiles/application-launched-image.png)

Visiting the port, we can see the Umbraco Installation page:

![Alt text](image-1.png)
![Alt text](readmefiles/application-launched-image-1.png)

After filling out the form, we can see the Clean Starter Kit:

![Alt text](image-2.png)
![Alt text](readmefiles/application-launched-image-2.png)

Umbraco's now configured to run in Docker! But we can do better. The following optional sections will configure automated installations, use usync to automatically copy data into the website, and connect an extra front-end server.

## Connecting to your Docker MSSQL databases

You can connect to your Docker hosted SQL with MSSQL Server Studio from your desktop. To connect as the Umbraco Application user, enter the following properties (values are set in the `.env` file, the port is set in `docker-compose.yml`):

- Server Type: Database Engine
- Server name: `localhost,1433`
- Authentication: `SQL Server Authentication`
- Login: `EXAMPLE_DATABASE_LOGIN_NAME`
- Password: `EXAMPLE_DATABASE_LOGIN_P@ssword`
- In the options tab >>
- Connect to database: `EXAMPLE_UMBRACO_DATABASE_NAME`


To connect as Admin, enter the following properties:

- Server Type: Database Engine
- Server name: `localhost,1433`
- Authentication: `SQL Server Authentication`
- Login: `sa`
- Password: `YOUR_PASS_goes_HERE@`
- In the options tab >>
- Connect to database: `EXAMPLE_UMBRACO_DATABASE_NAME`

# Teardown your new Docker environment

Note that you can reverse the `docker-compose up` command at any time by running
# Configure Frontend server(s)

`docker-compose down --rmi local --volumes`

This will remove any docker-compose generated components (including your media and data)
---


Expand Down
File renamed without changes
File renamed without changes
File renamed without changes

0 comments on commit f8e1e7c

Please sign in to comment.