Win11-Docker安装与IDEA集成

彼方

2022-08-31

Docker

1723

前言

有关Docker操作请在内网环境下操作，公网环境下操作，请参考以下连接配置TSL加密：
Docker启用TLS加密解决暴露2375端口引发的安全漏洞

Win11安装Docker

1.安装环境

电脑的环境如下：

Windows 11 家庭中文版-21H2
运行了Clash代理软件（此项会造成Docker启动失败）
已开启虚拟化（新电脑一般默认开启，老电脑需要手动开启）

注意：安装过程中需要多次重启电脑，请确保你电脑上的文件已经保存。

2.所需软件

注意：提前将下面的软件包下载好

wsl更新包下载地址：
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
Docker安装包下载地址

https://docs.docker.com/desktop/windows/install/
NoLSP下载地址

https://wwz.lanzouy.com/iq9jQ0amgunc

3.安装步骤

3.1 开启Hype-V

Windows家庭版默认没有开启Hype-V的选项，需要执行脚本开启

Windows专业版默认有开启Hype-V的选项，可以直接开启

家庭版按照以下步骤开启：

在桌面创建一个update.bat文件，将以下内容复制到文件中保存后右键以管理员身份运行，等待进度条走完后，输入 Y 确认安装。

pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL

然后以管理员身份运行PowerShell，执行以下几个命令：

# 启动WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 开启虚拟化
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完后，重启电脑，一般重启之后通过：控制面板—>程序---->启用或关闭Windows服务中可以找到Hype-V选项

专业版按照以下步骤开启：

直接通过：控制面板—>程序---->启用或关闭Windows服务中可以找到Hype-V选项，打开即可

3.2 更新WSL

下载上面的WSL更新文件并安装
使用管理员身份打开PowerShell，执行以下命令设置WSL2为默认版本
```
wsl --set-default-version 2
```
执行完成之后，需要重启电脑

3.3 修改默认安装位置

Docker默认安装位置为C盘，可以按照以下步骤将安装位置映射到D盘中

首先在D盘下创建Program Files文件夹，在Program Files文件夹下创建Docker文件夹
以管理身份打开CMD窗口，执行mklink /j "C:\Program Files\Docker" "D:\Program Files\Docker"命令映射文件夹
启动Docker安装包

4. 相关问题解决方案

4.1 安装WSL更新包时报错

安装WSL更新包时报错：

This update only applies to machines with the Windows Subsystem for Linux

出现此消息有三个可能的原因：

你仍使用旧版 Windows，不支持 WSL 2。有关版本要求和要更新的链接，请参阅下方说明：

若要更新到 WSL 2，需要运行 Windows 10/11。

Windows 1对于 x64 系统：版本 1903 或更高版本，采用 内部版本 18362 或更高版本/win11 直接升级到最新版本即可。
对于 ARM64 系统：版本 2004 或更高版本，采用 内部版本 19041 或更高版本。
低于 18362 的版本不支持 WSL 2。 使用 Windows Update 助手更新 Windows 版本。
若要检查 Windows 版本及内部版本号，选择 Windows 徽标键 + R，然后键入“winver”，选择“确定”。 （或者在 Windows 命令提示符下输入 ver 命令）

未启用 WSL。需要返回到步骤 3.1，并确保在计算机上启用了可选的 WSL 功能。
启用 WSL 后，需要重新启动才能使其生效，请重新启动电脑，然后重试。

4.2 Docker启动报错

Docker启动之后报如下错误：

我的电脑是因为开启了Clash代理软件，需要搭配Nolsp软件来解决，具体操作如下：

将下载的NoLsp软件放到：C:\Windows\System32目录下

执行以下代码：

NoLsp.exe c:\windows\system32\wsl.exe
wsl

重启Docker即可

IDEA集成Docker

在和前端联调的过程中，然后每次电脑使用IDEA将服务启动后不能动，然后自己想改变代码后重启可能导致前端那边报错，所以为了给前端提供联调的服务的同时，我自己还可以正常工作，于是便想到了使用docker的方式，这样就可以达到了两全其美，何乐而不为。

1.初识Docker

Docker的三个基本概念：

Dockerfile：镜像构建的模板，描述镜像构建的步骤，通常是拉去一些文件和依赖；
image：镜像，一个文件，用来创建容器。
container：容器，一个可运行的镜像实例，里面运行着一个完整的操作系统，可以做一切你当前操作系统可以做的事情。

从我的理解对上述三者做一个类比：dockerfile就是一个混凝土配比说明书(原材料，步骤等)，根据该说明书搅拌出混凝土(镜像)，然后基于混凝土可以做成一个一个房间(容器)，每个房间都是相互独立，生活着不同的人。

对于我们开发人员来说，Docker 可以做到：

编写本地代码
使用 Docker 将程序推送到测试环境
发现 bug 后在开发环境下修复，重新部署到测试环境测试
测试完成将代码合并到发布的代码分支

2.Docker基于Windows集成IDEA

2.1 在window上安装docker

注意一点：一定要把windows的WSL开启后再安装，否则会导致docker启动不成功。

2.2设置docker配置

开放2375端口，勾上该选项

在Docker Engine下使用以下文件替换，新增host:[ “0.0.0.0:2375”]

{
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  },
  "hosts": [
    "tcp://0.0.0.0:2375"
  ],
  "insecure-registries": [],
  "registry-mirrors": [
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

2.3 IDEA 连接docker 测试

老版本IDEA需要安装docker的插件，新版本的话不用安装直接使用

连接docker测试

说明：如果是本地的应用可以使用tcp://localhost:2375连接；如果是局域网的其他机器可以使用局域网ipv4连接；如果是远程机器的话使用公网ip连接。

如上图中出现Connection successful为成功标志

// 当使用ip访问时连接不成功的话在windows的admin权限终端窗口执行如下命令，端口代理
netsh interface portproxy add v4tov4 listenport=2375 connectaddress=127.0.0.1 connectport=2375 listenaddress=<your ipv4> protocol=tcp

//对2375端口添加防火墙规则
netsh advfirewall firewall add rule name="docker_daemon" dir=in action=allow protocol=TCP localport=2375

个人经历：完成了宿主机配置后，在局域网内的其他机器都是可以连接docker的，但是第二天早上再次连接就不行了，然后搞了好几天还是不行，突然一个偶然的机会又能重新连接上了。

//执行下述的命令 然后查看2375的端口
netsh interface portproxy show all

//删除所有的端口代理
netsh interface portproxy delete v4tov4   listenaddress=<your ipv4> listenport=2375

//重新执行端口代理
netsh interface portproxy add v4tov4 listenport=2375 connectaddress=127.0.0.1 connectport=2375 listenaddress=<your ipv4> protocol=tcp

在浏览器中访问yourip:2375/version测试，如果有数据返回那就是连接成功了。

提示：如果以上操作都做了还是连接不上，可以重启电脑试试，有奇效。

2.4启动Springboot应用测试

构建测试项目

@RestController
public class TestController {

    @GetMapping("/get/hello")
    public String get(){
        return "Hello World";
    }
}

@SpringBootApplication
public class SpringBootWithDockerStarter {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootWithDockerStarter.class, args);
    }
}

在项目中添加Dockerfile文件

#这是基础镜像
FROM java:8
VOLUME /tmp
#复制jar包到镜像中，并且将名字改成app.jar
ADD ./target/SpringBootWithDocker-1.0-SNAPSHOT.jar DemoApp.jar
#在容器启动的时候运行命令，来启动我们的项目（这其实就是一段Linux命令,该命令可以在服务启动时加一些参数）
ENTRYPOINT ["sh", "-c", "java -jar DemoApp.jar"]

上述注意一点：该文件的放置位置会影响ADD后面的寻找jar包的路径，因为我后面在build镜像时出现找不到jar的报错，原因就是我将该Dockerfile放在了该项目的某一个文件下了。

添加maven的docker打包插件

  <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin><!--制作docker镜像的maven插件-->
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>1.2.2</version>
                <executions>
                    <execution>
                        <id>build-image</id>
                        <phase>package</phase>
                        <goals>
                            <goal>build</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <imageName>${project.artifactId}</imageName><!--镜像名,注意:这里的镜像名一定要小写，如果你的应用名字是大写会报错的-->
                    <imageTags>
                        <imageTag>latest</imageTag>
                    </imageTags>
                    <dockerDirectory>${project.basedir}</dockerDirectory><!--Dockerfile所在的目录-->
                    <dockerHost>http://127.0.0.1:2375</dockerHost><!--docker所在的宿主机地址,或者填写http://yourip:2375-->
                    <resources>
                        <resource><!--这里配置的就是打包后jar所在的位置-->
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory><!--构建的class文件路径 一般是target-->
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
                </configuration>
            </plugin>
        </plugins>
    </build>

打包该应用程序

打包后会发现target目录下有jar包出现

新建一个Docker file配置文件

配置Docker，此处配置要和pom文件最终生成的名字tag要保持一致

部署项目后使用localhost:8080/get/hello访问返回数据即为成功

需要更新docker服务，需要重新使用mavne进行打包再重新进行容器构建即可

docker控制台中文乱码修复[可选]

//添加字符参数后 重启IDEA
-Dfile.encoding=UTF-8
-Dsun.jnu.encoding=UTF-8

3.Docker基于Linux集成IDEA

待更新。。。

4.连接宿主机redis服务

//添加Redis依赖
       <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis</artifactId>
        </dependency>
//添加Redis配置
# spring default config
spring.redis:
  host: your-ipv4 //宿主机的ip，如果你当前启动项目的docker没有安装redis，此处填localhost会报错
  port: 6379
  timeout: 5000
  lettuce.pool:
    # max connection number in connection poll, default number is 8
    max-active: 20
    # max wait time, default -1, this means there is no restrict. Unit: ms
    max-wait: -1
    # max idle connection number, default is 8
    max-idle: 8
    # min idle connection number, default is 0
    min-idle: 0

@Configuration
public class RedisConfig {

    @Bean(name = "redisTemplate")
    public StringRedisTemplate redisTemplate(RedisConnectionFactory redisConnectionFactory) {

        StringRedisTemplate stringRedisTemplate = new StringRedisTemplate();
        stringRedisTemplate.setConnectionFactory(redisConnectionFactory);
        return stringRedisTemplate;
    }
}

@RestController
@RequestMapping("/docker")
public class DockerController {
    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    @GetMapping("/redis/set")
    public String setRedisData(@RequestParam("value") String value){
        String key = "docker";
        stringRedisTemplate.opsForValue().set(key, value);
        String strValue = stringRedisTemplate.opsForValue().get(key);
        return strValue;
    }
}

//重新打包然后点击docker进行运行

5.连接docker中redis服务

获取redis的密码

使用命令连接容器：docker exec -it containerName /bin/bash
使用命令连接redis客户端：redis-cli
使用auth {password} 授权成功可以进行操作
在对spring-boot项目中修改配置之前，我们找到docker中redis在宿主机的端口号，这样我们才能保证连接成功。

修改项目中的配置

//添加Redis配置
# spring default config
spring.redis:
  host: your-ipv4 //宿主机的ip，如果你当前启动项目的docker没有安装redis，此处填localhost会报错
  port: 49153 //和上面图片的端口保持一致   <----第一处修改
  password: redispw //添加密码    <----第二处修改
  timeout: 5000
  lettuce.pool:
    # max connection number in connection poll, default number is 8
    max-active: 20
    # max wait time, default -1, this means there is no restrict. Unit: ms
    max-wait: -1
    # max idle connection number, default is 8
    max-idle: 8
    # min idle connection number, default is 0
    min-idle: 0

//重新打包进行部署