云原生专栏大纲
文章目录
- vscode-server介绍
- VSCode Server 和云开发结合
- vscode-server安装
- code-server安装插件
- 在线安装插件
- 离线安装插件
- 安装中文插件
- 配置开发环境
- 在容器中安装开放环境
- Dockerfile制作镜像
- git拉取项目
vscode-server介绍
VSCode Server(Visual Studio Code Server)是一个基于 Visual Studio Code 的远程开发解决方案。它允许你在远程服务器或容器中运行 VSCode,并通过浏览器或本地的 VSCode 客户端与之进行交互。简单总结是web版本VSCode。
VSCode Server 的工作原理是将 VSCode 的核心功能作为一个服务运行在远程环境中,而不是在本地机器上。通过与远程服务器建立连接,你可以在本地机器上的浏览器中打开 VSCode 界面,并像在本地运行 VSCode 一样进行代码编辑、调试和扩展安装等操作。
使用 VSCode Server 的好处包括:
- 资源隔离:你可以在远程服务器或容器中运行 VSCode,从而将开发环境与本地机器分离。这对于资源有限或需要特定环境的开发任务非常有用。
- 协作与共享:多个开发者可以同时连接到同一个远程 VSCode 实例,实现协同编辑和调试。这对于团队协作和知识共享非常有帮助。
- 跨平台支持:由于 VSCode Server 是通过浏览器访问的,因此可以在不同的操作系统上使用,包括 Windows、macOS 和 Linux。
- 扩展支持:VSCode Server 支持大多数 VSCode 扩展,你可以在远程环境中安装和使用你喜欢的扩展,以提供更丰富的开发体验。
要使用 VSCode Server,你需要在远程服务器或容器中安装并运行 VSCode Server,并通过浏览器访问它。可以使用 VSCode 客户端或者使用 VSCode 的 Remote Development 扩展来连接到远程 VSCode Server。
总而言之,VSCode Server 提供了一种灵活的远程开发解决方案,让你可以在远程环境中使用 VSCode 的强大功能,提高开发效率和协作能力。
VSCode Server 和云开发结合
VSCode Server 和云开发结合使用可以带来许多好处,下面是一些主要的好处:
- 灵活的开发环境: 云开发提供了弹性和可扩展的计算资源,使你能够根据需要创建和管理开发环境。通过在云上运行 VSCode Server,你可以随时随地使用浏览器访问你的开发环境,无需依赖特定的本地机器或配置。
- 资源隔离和共享: 在云上运行 VSCode Server 可以将开发环境与本地机器分离,这意味着你可以利用云提供的强大计算资源,而不会受限于本地机器的性能或存储容量。此外,多个开发者可以同时连接到同一个云上的 VSCode Server 实例,实现协同编辑和调试,促进团队协作和知识共享。
- 跨平台支持: 云开发平台通常支持多种操作系统,包括 Windows、macOS 和 Linux。这意味着你可以在不同的操作系统上使用浏览器访问云上的 VSCode Server,无需担心本地机器的兼容性问题。
- 数据安全和持久性: 在云上运行 VSCode Server 可以确保你的代码和开发环境的数据得到安全保护和持久化存储。云提供了备份、灾难恢复和数据安全性的机制,可以保障你的开发环境和数据的安全。
- 强大的扩展支持: VSCode Server 支持大多数 VSCode 扩展,你可以在云上的开发环境中安装和使用你喜欢的扩展,以提供更丰富的开发体验。这使得你可以根据项目需求自定义你的开发环境,并使用适合你的工作流程的工具和扩展。
总的来说,将 VSCode Server 和云开发结合使用可以提供灵活、可扩展和安全的开发环境,使你能够随时随地进行开发,并与团队成员共享和协作。这种组合可以提高开发效率、降低开发成本,并为你的项目提供更好的可管理性和可靠性。
vscode-server安装
linuxserver/code-server
version: "2.1"
services:code-server:image: lscr.io/linuxserver/code-server:latestcontainer_name: code-serverenvironment:- PUID=1000- PGID=1000- TZ=Etc/UTC- PASSWORD=password #optional- HASHED_PASSWORD= #optional- SUDO_PASSWORD=password #optional- SUDO_PASSWORD_HASH= #optional- PROXY_DOMAIN=code-server.my.domain #optional- DEFAULT_WORKSPACE=/config/workspace #optionalvolumes:- /path/to/appdata/config:/configports:- 8443:8443- 30000-39000:30000-39000restart: unless-stopped
建议此处预制一些端口,开发中可能会用到,如开发java项目远程debug等
参数 | 功能 |
---|---|
-p 8443 | Web 图形用户界面 |
-e PUID=1000 | 对于用户 ID - 请参阅下面的说明 |
-e PGID=1000 | 对于 GroupID - 请参阅下面的说明 |
-e TZ=Etc/UTC | 指定要使用的时区,请参阅此列表 。 |
-e PASSWORD=password | 可选的 web gui 密码,如果提供或未提供,则不会进行身份验证。PASSWORDHASHED_PASSWORD |
-e HASHED_PASSWORD= | 可选的 web gui 密码、覆盖、有关如何创建它的说明如下。PASSWORD |
-e SUDO_PASSWORD=password | 如果设置了此可选变量,则用户将具有使用指定密码在代码服务器终端中具有 sudo 访问权限。 |
-e SUDO_PASSWORD_HASH= | (可选)通过哈希设置 sudo 密码(优先于 var)。格式为 .SUDO_PASSWORD t y p e type typesalt$hashed |
-e PROXY_DOMAIN=code-server.my.domain | 如果设置了此可选变量,则将代理此域以进行子域代理。查看文档 |
-e DEFAULT_WORKSPACE=/config/workspace | 如果设置了此可选变量,则 code-server 将默认打开此目录 |
-v /config | 包含所有相关的配置文件。插件在config\extensions下 |
浏览器方式 http://ip:8443
code-server安装插件
在线安装插件
点击左侧菜单扩展->搜索插件名称->点击安装
离线安装插件
若是遇到在线安装插件失败的情况(网络原因),需要离线安装
- 确定安装的vscode-server版本
- 插件市场下载对应版本插件,插件市场:Visual Studio Marketplace
- 如搜索chinese安装中文插件
- 选择插件版本下载
- 点击拓展按钮➡点击右上角三个点···➡点击install from vsix
点击后展示如下,其中搜索框为容器中的文件系统路径
- 通过Xftp工具将下载插件上传到服务器挂载的容器路径下,点击安装即可
安装中文插件
配置开发环境
注意:安装vscode-server默认安装git,个人推荐在容器中安装开放环境重新打包docker镜像,原因很简单有一些环境或者插件在开发过程中才察觉到进行安装,此时重新打包镜像就好,等逐步完善了在重新制作Dockerfile
下载jdk和maven安装包 jdk官网下载 maven官网下载
在容器中安装开放环境
vs-code的java扩展需要jdk-11以上,而我们很多项目还停留在古老的jdk-8,所以需要两个都安装,启动vs-code使用11,编译运行项目使用jdk8.
- docker以root身份进入容器
docker exec -it --user root <container_id> /bin/bash
- 在容器内部安装jdk、Maven等,建议下载安装包离线安装(挂载好管理)
# 容器在线安装
sudo apt update
sudo apt install openjdk-11-jdk
sudo apt install openjdk-8-jdk
sudo apt install openjdk-17-jdk
java -versionsudo apt install maven
mvn --versionsudo apt install nodejs npm
node --version
npm --version
- 离线安装jdk并配置环境变量
# 要将宿主机文件上传到Docker容器中,离线安装放在/opt目录下
docker cp <宿主机文件路径> <容器名称或ID>:<容器内目标路径>
#解压
tar -zxvf jdk-11.0.11_linux-x64_bin.tar.gz# # 设置环境变量,Ctrl + O保存 | Ctrl + x退出
sudo nano /etc/profile
#文件增加如下代码
JAVA_HOME=/opt/jdk-11.0.21
export PATH=${JAVA_HOME}/bin:$PATH# 执行命令重新生效
. /etc/profile#查看java版本
java -version
- 离线安装maven
# 下载
http://maven.apache.org/download.cgi
# 解压
tar zxvf apache-maven-3.9.6-bin.tar.gz# 设置环境变量,Ctrl + O保存 | Ctrl + x退出
sudo nano /etc/profile
# 添加如下配置
MAVEN=/opt/apache-maven-3.9.6
export PATH=${JAVA_HOME}/bin:${MAVEN}/bin:$PATH# 配置文件生效
. /etc/profile# 验证
mvn -v
- 浏览器中访问vscode 验证环境
- 修改maven配置
nano /usr/share/maven/conf/settings.xml
# 根据自身情况修改,/usr/share/maven映射的/etc/maven
# 建议将/usr/share/maven/conf/settings.xml挂载出去
# 建议将settings.xml中localRepository私有仓库路径修改到挂载路径下
- 将容器重新打包为docker镜像
# 停止容器
docker stop <容器名称或容器ID>
# 容器打包镜像
docker commit <容器名称或容器ID> <新镜像名称>
# docker commit 命令只会将容器的文件系统快照保存为一个新的镜像,并不包括容器的数据卷或其他持久化数据
# 所有/config下文件不会打包到镜像中,需挂载出来持久存储
在使用 docker commit 命令创建镜像时,文件系统指的是容器的根文件系统,包括容器中的所有文件和目录。这包括容器中的操作系统文件、安装的软件、用户数据等。
具体来说,文件系统路径包括但不限于以下内容:
- /bin, /sbin, /usr/bin, /usr/sbin: 可执行文件的路径。
- /etc: 配置文件的路径。
- /opt:用于存放可选的应用程序和软件包
- /lib, /lib64, /usr/lib, /usr/lib64: 库文件的路径。
- /usr/share: 共享数据的路径。
- /var: 可变数据的路径,例如日志文件、数据库文件等。
- /home: 用户主目录的路径。
当你使用 docker commit 命令创建镜像时,它会将容器的整个文件系统快照保存为一个新的镜像。这意味着镜像将包含容器中的所有文件和目录,以及容器的文件系统状态。
需要注意的是,docker commit 命令创建的镜像可能会变得很大,因为它包含了容器的完整文件系统。在生产环境中,建议使用 Dockerfile 和适当的构建步骤来创建镜像,以便更好地管理镜像的大小和内容。
- 导出镜像
docker save -o <目标文件名.tar> <镜像名称:标签>
- 加载镜像
docker load -i <导出的镜像文件.tar>
- 将镜像上传到harbor(建议上传到稳定的仓库,如阿里云仓库)
docker login <Harbor地址> -u <用户名> -p <密码>
docker tag <镜像名称:标签> <Harbor地址>/<项目名称>/<镜像名称:标签>
- 修改docker-compose.yaml文件volumes配置
version: "2.1"
services:code-server:image: 导出的本地镜像(上传后使用服务路径镜像)container_name: my-code-server-javaenvironment:- PUID=1000- PGID=1000- DEFAULT_WORKSPACE=/config/workspace- PASSWORD=123456- TZ=Asia/Shanghaivolumes:- ./config:/config- ./config/maven/conf:/opt/apache-maven-3.9.6/conf ports:- 99:8443restart: unless-stopped
Dockerfile制作镜像
- 上述操作容器一旦重启会丢失,建议参考GitHub - linuxserver/docker-code-server重新制作镜像,Dockerfile.yml
FROM ghcr.io/linuxserver/baseimage-ubuntu:jammy
# set version label
ARG BUILD_DATE
ARG VERSION
ARG CODE_RELEASE
LABEL build_version="Linuxserver.io version:- ${VERSION} Build-date:- ${BUILD_DATE}"
LABEL maintainer="aptalca"# environment settings
ARG DEBIAN_FRONTEND="noninteractive"
ENV HOME="/config"RUN \echo "**** install runtime dependencies ****" && \apt-get update && \apt-get install -y \git \jq \libatomic1 \nano \net-tools \netcat \sudo && \echo "**** install code-server ****" && \if [ -z ${CODE_RELEASE+x} ]; then \CODE_RELEASE=$(curl -sX GET https://api.github.com/repos/coder/code-server/releases/latest \| awk '/tag_name/{print $4;exit}' FS='[""]' | sed 's|^v||'); \fi && \mkdir -p /app/code-server && \curl -o \/tmp/code-server.tar.gz -L \"https://github.com/coder/code-server/releases/download/v${CODE_RELEASE}/code-server-${CODE_RELEASE}-linux-amd64.tar.gz" && \tar xf /tmp/code-server.tar.gz -C \/app/code-server --strip-components=1 && \echo "**** clean up ****" && \apt-get clean && \rm -rf \/config/* \/tmp/* \/var/lib/apt/lists/* \/var/tmp/*# add local files
COPY ./root /##########安装java相关环境########################
# 思路:将离线下载安装包拷贝进来安装,在删除安装包
#https://www.oracle.com/java/technologies/downloads/
#https://adoptopenjdk.net/?variant=openjdk8&jvmVariant=hotspot
#https://maven.apache.org/index.html
# 安装OpenJDK 11
RUN apt-get update && \apt-get install -y openjdk-11-jdk# 安装Maven
RUN apt-get install -y maven# 安装Node.js
RUN apt-get install -y curl && \curl -sL https://deb.nodesource.com/setup_14.x | bash - && \apt-get install -y nodejs# 设置环境变量
ENV JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
ENV PATH=$PATH:$JAVA_HOME/bin
################################### ports and volumes
EXPOSE 8443
- 打包镜像
docker build -t <image_name>:<tag> .
git拉取项目
- 拉取项目
- 右击运行项目进入断点