Контейнерное развертывание .NET Core+MySql+Nginx

.NET Docker

  1. Контейнеризация .NET Core @Docker
  2. Развертывание мультиконтейнерных приложений .NET Core @Docker-Compose
  3. Контейнерное развертывание .NET Core+MySql+Nginx
  4. GitHub-демонстрация: Docker.NetCore.MySql

1. Введение

В последних двух разделах мы изучили основные операции докера с помощью простой демонстрации. В этом разделе мы проведем углубленное исследование, чтобы завершить контейнерное развертывание ASP.NET Core + MySql + Nginx.

Эта статья основана на среде CentOS 7.4 для демонстрации, пример проекта можно получить*Docker.NetCore.MySql*скачивать.

2. Hello MySQL

Опять же, действуем поэтапно. Во-первых, давайте попробуем MySQL на основе Docker.

2.1. Создайте экземпляр MySql

//拉取mysql镜像
 docker pull mysql
$ docker images$
REPOSITORY                           TAG                 IMAGE ID            CREATED             SIZE
docker.io/mysql                      latest              7d83a47ab2d2        13 days ago         408.2 MB
//创建一个mysql实例
$ docker run --name hello.mysql -e MYSQL_ROOT_PASSWORD=123456 -d mysql
$ docker ps 
CONTAINER ID        IMAGE      COMMAND                  CREATED             STATUS              PORTS          NAMES
e21bbd84e0b5        mysql      "docker-entrypoint.sh"   3 minutes ago       Up 3 minutes        3306/tcp        hello.mysql

Ниже мы подключаемся прямо в контейнере к только что созданной базе данных mysql:

$ docker exec -it hello.mysql \
> mysql -uroot -p123456
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 5.7.20 MySQL Community Server (GPL)

Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
4 rows in set (0.00 sec)

2.2. Монтирование тома данных

Данные созданного выше экземпляра MySQL хранятся внутри контейнера, что создает проблему: если контейнер будет уничтожен, соответствующие данные базы данных будут потеряны. Итак, как сохранить данные в контейнере хранилища? Мы можем решить эту проблему, смонтировав том данных.

//创建数据卷
$ docker volume create --name hello.db
hello.db
//查看数据卷信息
$ docker volume inspect hello.db
[
    {
        "Name": "hello.db",
        "Driver": "local",
        "Mountpoint": "/var/lib/docker/volumes/hello.db/_data",
        "Labels": {},
        "Scope": "local"
    }
]
// 挂载数据卷启动MySql实例
$ docker run --name hello.mysql \
> -v hello.db:/var/lib/mysql \
> -e MYSQL_ROOT_PASSWORD=123456 -d mysql

Вышеупомянутое используется с использованиемdocker volume createКоманда создает том данных, конечно, мы также можем сами смонтировать каталог как том данных.

3. Подготовьте проект .NET Core+EFCore+MySql.

Для удобства демонстрации я подготовил пример проекта ASP.NET Core+EFCore+MySql. Его структура выглядит следующим образом:

示例项目结构
Он основан на проекте шаблона .NET Core Mvc, который определяетProductсущность и черезProductsControllerОткройте интерфейс WebApi. Основной код выглядит следующим образом:

Класс объекта продукта:

public class Product
{
    public int ProductId { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
    public int StockQty { get; set; }
}

Класс ДбКонтекст:

public class MySqlDbContext : DbContext
{
    public MySqlDbContext (DbContextOptions<MySqlDbContext> options)
        : base(options)
    {
    }

    public DbSet<Product> Products { get; set; }
}

Класс инициализации базы данных:

public class DbInitializer
{
    public static void Initialize(MySqlDbContext context)
    {
        context.Database.EnsureCreated();

        if (context.Products.Any())
        {
            return;
        }

        var products = new Product[]
        {
            new Product{Name="iphone 6",Price=5000,StockQty=10 },
            new Product{Name="iphone 7",Price=6000,StockQty=10 },
            new Product{Name="iphone 7 plus",Price=7000,StockQty=10 },
            new Product{Name="iphone x",Price=8000,StockQty=10 }
        };

        context.Products.AddRange(products);

        context.SaveChanges();
    }
}

Этот класс инициализации базы данных запускается при запуске проекта. Подробный код см. **Docker.NetCore.MySql**.

4. Практические занятия на основе типовых проектов

4.1 Установите Git и клонируйте образец проекта

$ yum install git
$ git --version
git version 1.8.3.1
$ cd ~/demo
$ git clone https://github.com/yanshengjie/Docker.NetCore.MySql.git
Cloning into 'Docker.NetCore.MySql'...
remote: Counting objects: 155, done.
remote: Compressing objects: 100% (125/125), done.
remote: Total 155 (delta 42), reused 123 (delta 25), pack-reused 0
Receiving objects: 100% (155/155), 534.30 KiB | 333.00 KiB/s, done.
Resolving deltas: 100% (42/42), done.

4.2. Создание образа

Внимательно вы обнаружите, что файл Dockerfile был определен в проекте, поэтому мы можем использовать его напрямую.docker buildСоздайте образ.

# cd Docker.NetCore.MySql
[root@iZ288a3qazlZ Docker.NetCore.MySql]# ls
appsettings.Development.json  docker-compose.yml           Program.cs             Views
appsettings.json              Dockerfile                   proxy.conf             wwwroot
bundleconfig.json             Docker.NetCore.MySql.csproj  README.md
Controllers                   LICENSE                      ScaffoldingReadMe.txt
Data                          Models                       Startup.cs
//构建镜像
# docker build -t docker.netcore.mysql .
Sending build context to Docker daemon 3.045 MB
Step 1 : FROM microsoft/dotnet:latest
 ---> 7d4dc5c258eb
Step 2 : WORKDIR /app
 ---> Using cache
 ---> 98d48a4e278c
Step 3 : COPY . /app
 ---> 6b1bf8bb5261
Removing intermediate container b86460477977
Step 4 : RUN dotnet restore
 ---> Running in 4e0a46f762bb
  Restoring packages for /app/Docker.NetCore.MySql.csproj...
  Installing Microsoft.CodeAnalysis.Razor 2.0.0.
  .....
  Restore completed in 216.83 ms for /app/Docker.NetCore.MySql.csproj.
 ---> 4df70c77916e
Removing intermediate container 4e0a46f762bb
Step 5 : EXPOSE 5000
 ---> Running in 11b421b3bd3e
 ---> 3506253060fe
Removing intermediate container 11b421b3bd3e
Step 6 : ENV ASPNETCORE_URLS http://*:5000
 ---> Running in 201aabbab72c
 ---> 7f29963a8d96
Removing intermediate container 201aabbab72c
Step 7 : ENTRYPOINT dotnet run
 ---> Running in c79f73cba162
 ---> 9d1fb6ee46cb
Removing intermediate container c79f73cba162
Successfully built 9d1fb6ee46cb
[root@iZ288a3qazlZ Docker.NetCore.MySql]# docker images docker.netcore.mysql
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
docker.netcore.mysql   latest              9d1fb6ee46cb        13 seconds ago      1.756 GB

4.3 Запустите зеркалирование и подключитесь к указанной базе данных

докер предоставляет--linkПараметры используются для установления соединений между контейнерами. Ниже мы создаем созданный образdocker.netcore.mysqlи назовите контейнер какhello.netcore.mysql, и используйте параметр --link с установленным в начале нашей статьиhello.mysqlКонтейнер устанавливает соединение.

# docker run --name hello.netcore.mysql --link hello.mysql:db -d -p 5000:5000 
docker.netcore.mysql

Здесь следует обратить особое внимание--link=hello.mysql:db, этот параметр указывает контейнеру Docker использоватьhello.mysqlконтейнер и псевдоним для db, так что вhello.netcore.mysqlВ этом контейнере db можно использовать как сервер, предоставляющий службы базы данных mysql. Вот почему строка подключения в нашем проекте .NET Core имеет значениеserver=db;причина."ConnectionStrings": { "MySql": "server=db;database=MySqlDbContext;uid=root;pwd=123456;" }

//查看运行中容器列表
# docker ps 
CONTAINER ID        IMAGE                  COMMAND                  CREATED             STATUS              PORTS                    NAMES
5cbfd27ebe2a        docker.netcore.mysql   "dotnet run"             2 minutes ago       Up 2 minutes        0.0.0.0:5000->5000/tcp   hello.netcore.mysql
4dfa4159b669        mysql                  "docker-entrypoint.sh"   About an hour ago   Up About an hour    3306/tcp                 hello.mysql
//访问api/products
[root@iZ288a3qazlZ Docker.NetCore.MySql]# curl http://localhost:5000/api/products
[{"productId":1,"name":"iphone 6","price":5000.0000000000000000000000000,"stockQty":10},{"productId":2,"name":"iphone 7","price":6000.0000000000000000000000000,"stockQty":10},{"productId":3,"name":"iphone 7 plus","price":7000.0000000000000000000000000,"stockQty":10},{"productId":4,"name":"iphone x","price":8000.000000000000000000000000,"stockQty":10}]

Как видно из рисунка выше, мы завершили соединение между .NET Core и MySql.

5. ASP.NET Core + MySql + Nginx

Объединить предыдущую статьюРазвертывание мультиконтейнерных приложений .NET Core @Docker-Compose, давайте воспользуемся docker-compose для завершения многоконтейнерного развертывания asp.net core + mysql + nginx.

5.1 Определение файла docker-compose.yml

version: '2'
services:
  db:
    container_name: hello.db
    environment:
      MYSQL_ROOT_PASSWORD: 123456
  volumes:
    - ./mysql:/var/lib/mysql

  web:
    container_name: hello.web
    build: .
    depends_on:
      - db
    links:
      - db
  
  reverse-proxy:
    container_name: hello.proxy
    image: nginx
    depends_on:
      - web
    ports:
      - "9090:8080"
    volumes:
      - ./proxy.conf:/etc/nginx/conf.d/default.conf

Определены три услуги:

  1. db: используйте образ mysql и смонтируйте папку mysql в текущем проекте для постоянного хранения.
  2. web: служба контейнера, созданная на основе текущего проекта и зависящая от службы db.
  3. reverse-proxy: используйте nginx для определения службы обратного прокси, которая монтирует файл proxy.conf в текущем проекте в качестве файла конфигурации обратного прокси. Конфигурация proxy.conf выглядит следующим образом (обратите внимание, что URL-адрес, указанный proxy_pass, имеет вид http://web:5000):
server {
    listen 8080;

    location / {
        proxy_pass http://web:5000;
    }
}

5.2. Начать написание

Перед запуском Compose рекомендуется очистить созданный выше контейнер. также можно использоватьdocker rm $(docker ps -qa)Очистите все контейнеры.

//启动compose
[root@iZ288a3qazlZ Docker.NetCore.MySql]# docker-compose up -d
Creating network "dockernetcoremysql_default" with the default driver
Building web
Step 1 : FROM microsoft/dotnet:latest
 ---> 7d4dc5c258eb
Step 2 : WORKDIR /app
 ---> Using cache
 ---> 98d48a4e278c
Step 3 : COPY . /app
 ---> d41b32323c0f
Removing intermediate container 1259f5fb82bc
Step 4 : RUN dotnet restore
 ---> Running in d482e355de77
  Restoring packages for /app/Docker.NetCore.MySql.csproj...
  Installing Microsoft.CodeAnalysis.Razor 2.0.0.
  .....
  Restore completed in 216.83 ms for /app/Docker.NetCore.MySql.csproj.
 ---> a0658008f161
Removing intermediate container d482e355de77
Step 5 : EXPOSE 5000
 ---> Running in dc6eeb29fd5e
 ---> a419314ece08
Removing intermediate container dc6eeb29fd5e
Step 6 : ENV ASPNETCORE_URLS http://*:5000
 ---> Running in c1d1474b14a0
 ---> 9cc13c549042
Removing intermediate container c1d1474b14a0
Step 7 : ENTRYPOINT dotnet run
 ---> Running in efdf0e857a84
 ---> 830ac11428cf
Removing intermediate container efdf0e857a84
Successfully built 830ac11428cf
Creating hello.db ... done
Creating hello.web ... done
Creating hello.proxy ... done
Creating hello.web ...
Creating hello.proxy ...
[root@iZ288a3qazlZ Docker.NetCore.MySql]# docker ps
CONTAINER ID        IMAGE                    COMMAND                  CREATED             STATUS              PORTS                            NAMES
6253bf85682e        nginx                    "nginx -g 'daemon off"   33 seconds ago      Up 28 seconds       80/tcp, 0.0.0.0:9090->8080/tcp   hello.proxy
ea553a9e22f2        dockernetcoremysql_web   "dotnet run"             37 seconds ago      Up 32 seconds       5000/tcp                         hello.web
a1f5aa981bfb        mysql                    "docker-entrypoint.sh"   38 seconds ago      Up 36 seconds       3306/tcp                         hello.db
[root@iZ288a3qazlZ Docker.NetCore.MySql]# docker-compose ps
   Name                 Command             State               Ports
----------------------------------------------------------------------------------
hello.db      docker-entrypoint.sh mysqld   Up      3306/tcp
hello.proxy   nginx -g daemon off;          Up      80/tcp, 0.0.0.0:9090->8080/tcp
hello.web     dotnet run                    Up      5000/tcp
[root@iZ288a3qazlZ Docker.NetCore.MySql]# curl http://localhost:9090/api/products
[{"productId":1,"name":"iphone 6","price":5000.0000000000000000000000000,"stockQty":10},{"productId":2,"name":"iphone 7","price":6000.0000000000000000000000000,"stockQty":10},{"productId":3,"name":"iphone 7 plus","price":7000.0000000000000000000000000,"stockQty":10},{"productId":4,"name":"iphone x","price":8000.000000000000000000000000,"stockQty":10}]

Приведенные выше результаты выполнения показывают, что мы успешно завершили развертывание многоконтейнерного приложения ASP.NET Core+MySql+Nginx. Доступ через браузерhttp:<ipaddress>:9090/api/productsВы можете получить доступ к нашему открытому API.

5.3 Проверка базы данных

Давайте проверим, что база данных была создана успешно:

[root@iZ288a3qazlZ Docker.NetCore.MySql]# ls mysql
auto.cnf         client-key.pem         ib_logfile0  performance_schema  server-key.pem
ca-key.pem       MySqlDbContext  ib_logfile1  private_key.pem     sys
ca.pem           ib_buffer_pool         ibtmp1       public_key.pem
client-cert.pem  ibdata1                mysql        server-cert.pem
[root@iZ288a3qazlZ Docker.NetCore.MySql]# docker exec -it hello.db mysql -uroot -p123456
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 5.7.20 MySQL Community Server (GPL)

Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql> show databases;
+-----------------------+
| Database              |
+-----------------------+
| information_schema    |
| MySqlDbContext  |
| mysql                 |
| performance_schema    |
| sys                   |
+-----------------------+
5 rows in set (0.00 sec)

mysql> use MySqlDbContext;
Reading table information for completion of table and column names
You can turn off this feature to get a quicker startup with -A

Database changed
mysql> show tables;
+---------------------------------+
| Tables_in_MySqlDbContext |
+---------------------------------+
| Products                        |
+---------------------------------+
1 row in set (0.00 sec)

mysql> select * from Products;
+-----------+---------------+-------------------------------------+----------+
| ProductId | Name          | Price                               | StockQty |
+-----------+---------------+-------------------------------------+----------+
|         1 | iphone 6      | 5000.000000000000000000000000000000 |       10 |
|         2 | iphone 7      | 6000.000000000000000000000000000000 |       10 |
|         3 | iphone 7 plus | 7000.000000000000000000000000000000 |       10 |
|         4 | iphone x      | 8000.000000000000000000000000000000 |       10 |
+-----------+---------------+-------------------------------------+----------+
4 rows in set (0.00 sec)

Исходя из приведенных выше результатов, мы можем успешно смонтировать папку mysql в папке проекта в контейнер для сохранения данных.

6. Наконец

В этой статье сначала описывается, как создать экземпляр контейнера MySQL на основе Docker, затем как сохранить данные MySQL путем монтирования тома данных и как использовать параметр --Link для подключения между контейнерами для завершения подключения .NET Core к базе данных MySQL. . Наконец, использование Docker-Compose для интеграции ASP.NET Core+MySQL+Nginx для завершения контейнерного развертывания.

В следующем разделе мы расскажем, как использовать Docker-Swarm для развертывания кластера.

7. Ссылки

  1. mysql -Docker Documentation
  2. Hello Docker
  3. Контейнеризация .NET Core @Docker
  4. Развертывание мультиконтейнерных приложений .NET Core @Docker-Compose