windows WSL安装hedgedoc

1. Git
   WSL似乎默认装好了git, 用下面命令查一下可以查到

   root@DESKTOP-FTUL9EC:~# git --version
   git version 2.25.1
   

2. Docker 17.03.1 or higher
   看了官方文档，安装docker engine需要如下ubuntu版本：
   Ubuntu Lunar 23.04
   Ubuntu Kinetic 22.10
   Ubuntu Jammy 22.04 (LTS)
   Ubuntu Focal 20.04 (LTS)
   Ubuntu Bionic 18.04 (LTS)

   而我的WSL版本是Ubuntu 20.04 (LTS)，满足要求,我选择了通过“apt repository”安装docker engine，按照官网上给的步骤安装即可。注意！要用wsl2以及Ubuntu 20.04 (LTS)， 不要用wsl1和Ubuntu 18.04，否则会遇到难以解决的莫名其妙的问题。

   PS C:\Users\xx>wsl --set-default-version 2
   PS C:\Users\xx>wsl --install  Ubuntu-20.04
   PS C:\Users\xx> wsl -l -v
   NAME                   STATE           VERSION
   Ubuntu-20.04           Running         2
   

   步骤：

   1. 更新你现有的软件包列表，并为后面的步骤安装一些依赖项

      $ sudo apt update
      $ sudo apt install ca-certificates curl gnupg lsb-release
      

      Docker将软件包发布到自己的 apt 仓库。你需要将这个仓库添加到你的 apt 源列表中，否则，你的 apt 安装将无法找到Docker包。

      ca-certificates, curl, gnupg 和 lsb_release 工具将被用来下载正确的Docker apt 仓库细节和你系统的签名密钥。尽管你可能已经有了这些软件包，但确保它们是可用的也无妨。

      2. 在apt上注册Docker的GPG密钥圈。这将让 apt 验证你安装的Docker包。

      $ sudo mkdir -p /etc/apt/keyrings
      $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
      $ sudo chmod a+r /etc/apt/keyrings/docker.gpg
      

      curl 命令为Ubuntu下载Docker的GPG密钥，将其转换为标准的OpenGPG编码，并将其保存到apt的keyring目录中。

      chmod 用来设置keyring文件的权限，以便 apt 能够可靠地检测到它。
      3. 把Docker包的源代码添加到你的系统中

      echo \
        "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
        "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
        sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
      

      4. 再次更新你的软件包列表，让 apt 知道Docker软件包的存在

      $ sudo apt update
      

      5. 使用 apt install 命令将Docker的组件添加到系统中

      sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
      

      6. 验证docker engine是否安装成功

      sudo docker run hello-world
      

      出现“ Unable to find image 'hello-world:latest' locally， latest: Pulling from library/hello-world，719385e32844: Pull complete”，表明docker engine安装成功了。

3. Docker Compose
   apt install docker-compose

4. 从官网找到最新的docker compose.yml文件配置，并拷贝到wsl你想要放的位置，如~/hedgedoc.

   root@DESKTOP-FTUL9EC:~# mkdir hedgeDoc
   root@DESKTOP-FTUL9EC:~# cd hedgeDoc/
   root@DESKTOP-FTUL9EC:~#  cp /mnt/d/hedgeDoc .  #从windows把docker compose.yml拷贝到wsl
   root@DESKTOP-FTUL9EC:~/hedgeDoc# docker-compose up -d
   

   docker会开始下载镜像启动容器，如果看到下面的输出则表示成功了。

   b0c140f524d9: Pull complete
   Digest: sha256:2763471ad097ea6650f7486024aceec0dfd8cdb4850c8c38e4e293f8309ad16d
   Status: Downloaded newer image for quay.io/hedgedoc/hedgedoc:1.9.7
   Creating hedgedoc_database_1 ... done
   Creating hedgedoc_app_1 ... done

5. 在浏览器访问 http://localhost:3000/ , 即可看到hedgedoc的首页。开始写你的markdown文档吧~
   

附：docker-compose.yml

          version: '3'
          services:
            database:
              image: postgres:13.4-alpine
              environment:
                - POSTGRES_USER=hedgedoc
                - POSTGRES_PASSWORD=password
                - POSTGRES_DB=hedgedoc
              volumes:
                - database:/var/lib/postgresql/data
              restart: always
            app:
              # Make sure to use the latest release from https://hedgedoc.org/latest-release
              image: quay.io/hedgedoc/hedgedoc:1.9.7
              environment:
                - CMD_DB_URL=postgres://hedgedoc:password@database:5432/hedgedoc
                - CMD_DOMAIN=localhost
                - CMD_URL_ADDPORT=true
              volumes:
                - uploads:/hedgedoc/public/uploads
              ports:
                - "3000:3000"
              restart: always
              depends_on:
                - database
          volumes:
            database:
            uploads:
        ```