用自己的服务器利用WorkAdventure创建一个虚拟办公室

简要概括
以下是一份為安裝和設定WorkAdventure的逐步指南的文件。
关于WorkAdventure
-
- WorkAdventureは、16ビットのRPGビデオゲームの形で提供される協同ウェブアプリケーションです。
-
- この革新的なリモートコラボレーションのアプローチは、ユニークでエンゲージングな、バーチャルオフィスのような環境を提供します。
- 詳細については、公式ウェブサイトをご覧いただくか、プロジェクトのGitHubページをチェックしてください。
推動行動的力量或原因。
-
- 最初にWorkAdventureをインストールするとき、少しチャレンジングに感じるかもしれません。
-
- 私はこのガイドを書くことで、他の人々のプロセスを簡単にすることができました。
- もしこれが1人でも助けになるのであれば、私は満足です。
安装指南
前提条件 (Qian ti tiao jian)
在开始之前,值得提及的是,在以下规格的服务器上测试过并确认了该指南的步骤是有效的。
-
- ディストリビューション: Canonical, Ubuntu Server Pro, 22.04 LTS, amd64 jammy image built on 2023-05-16
-
- CPUアーキテクチャ:x86_64 (このガイドはARMベースのCPUをサポートしていません)
-
- AMI:ami-0702b27a97d5bbcba
-
- インスタンスタイプ:t2.medium (4GB Memory)
- ストレージ:20GB
环境变量
使用以下变量来设置环境
version=v1.15.11
domain=your.example.com
步骤1:安装Docker
-
- 私たちはこのインストールのためにDockerを使用します。
-
- まだUbuntuサーバーにDockerをインストールしていない場合は、Dockerの公式ドキュメンテーションで利用可能な指示に従ってインストールすることができます。
- あるいは、以下のスクリプトを使用してDockerをインストールすることもできます
$(cat << 'EOF' > ~/install-docker.sh
sudo apt-get remove docker docker-engine docker.io containerd runc
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo install -m 0755 -d /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
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
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin docker-compose
sudo docker run hello-world
EOF
)
/bin/bash ~/install-docker.sh
步骤2:克隆WorkAdventure的存储库并准备部署文件。
-
- 次のステップは、WorkAdventureのリポジトリをクローンし、必要なデプロイメントファイルを準備することです。
- これを達成するために以下のコマンドを使用します
cd
$(cat << EOF > ~/copy-deployment-files
mkdir -p ~/git
cd ~/git
sudo rm -fr ~/git/workadventure
git clone https://github.com/thecodingmachine/workadventure.git -b $version
cd ~/git/workadventure/contrib/docker
cp .env.prod.template .env
cp docker-compose.prod.yaml docker-compose.yaml
EOF
)
/bin/bash ~/copy-deployment-files
第三步:设置环境
在安装了Docker并克隆了存储库后,使用以下脚本来配置环境。
cd
$(cat << EOF > ~/configure-your-environment.sh
cd ~/git/workadventure/contrib/docker
sed -i 's/^SECRET_KEY=$/SECRET_KEY=foobar/' .env
sed -i "s/^DOMAIN=workadventure.localhost$/DOMAIN=${domain}/" .env
sed -i "s/workadventure.localhost/${domain}/" .env
sed -i "s/^VERSION=master$/VERSION=${version}/" .env
sed -i "s/^MAP_STORAGE_AUTHENTICATION_USER=$/MAP_STORAGE_AUTHENTICATION_USER=map-storage-user/" .env
sed -i "s/^MAP_STORAGE_AUTHENTICATION_PASSWORD=$/MAP_STORAGE_AUTHENTICATION_PASSWORD=map-storage-pass/" .env
sed -i 's/^ADMIN_API_URL=$/#ADMIN_API_URL=/' .env
echo PLAY_HOST=play.$domain >> .env
EOF
)
/bin/bash ~/configure-your-environment.sh
sed -i '/PROMETHEUS_AUTHORIZATION_TOKEN: "$PROMETHEUS_AUTHORIZATION_TOKEN"/a \
AUTHENTICATION_STRATEGY: "Basic"\
AUTHENTICATION_TOKEN: "token"\
AUTHENTICATION_USER: "user"\
AUTHENTICATION_PASSWORD: "pass"' ~/git/workadventure/contrib/docker/docker-compose.yaml
第四步:启动WorkAdventure环境。
当环境设置完成后,可使用以下命令启动WorkAdventure环境。
cd ~/git/workadventure/contrib/docker && sudo docker-compose up
步骤5:创建并上传第一张地图。
-
- WorkAdventureは、仮想空間を定義するマップで操作します。
- ここでは、最初のマップを作成し、それをサーバーにアップロードする方法を紹介します
# Delete old repository and clone repository
mkdir -p ~/git
cd ~/git
rm -fr workadventure-map-starter-kit
git clone https://github.com/thecodingmachine/workadventure-map-starter-kit.git -b v3.3.3
cd ~/git/workadventure-map-starter-kit
# volta pin node@20 # Use Node.js v20 via volta
npm ci
# Build
npm run build
mv dist map
zip -r map.zip map
cp map.zip ~/Desktop
安装测试
-
- WorkAdventureをインストールし、最初のマップをアップロードしたので、それをテストする時が来ました。
-
- 以下に有用なリンクをいくつか提供します
マップのアップロード
https://map-storage.YOUR.EXAMPLE.COM/
ユーザー : user
パスワード : pass
ディレクトリ: /
マップの表示
https://map-storage.YOUR.EXAMPLE.COM/maps
プレイ
https://play.YOUR.EXAMPLE.COM/_/global/map-storage.YOUR.EXAMPLE.COM/map/map.tmj
以后的工作
-
- ビデオ会議機能を提供するためにJitsiを統合
- サーバー操作のための正しいタイムゾーンを設定
WorkAdventure的安装和设置只是旅程的开始。
请享受探索和创建你自己独特的虚拟办公室的乐趣!