یک دفتر مجازی با WorkAdventure بر روی سرور خود ایجاد کنید

درباره WorkAdventure

WorkAdventure یک برنامه وب مشترک است که در قالب یک بازی ویدیویی RPG 16 بیتی ارائه شده است. این رویکرد نوآورانه برای همکاری از راه دور محیطی منحصر به فرد، جذاب و شبیه دفتر مجازی را ارائه می دهد.

برای اطلاعات بیشتر، از وب سایت رسمی بازدید کنید یا صفحه GitHub پروژه را بررسی کنید.

انگیزه

نصب WorkAdventure در ابتدا می تواند کمی چالش برانگیز به نظر برسد. من این راهنما را نوشته ام تا فرآیند را برای دیگران ساده تر کنم. اگر بتواند حتی به یک نفر کمک کند، راضی خواهم بود.

راهنمای نصب

پیش نیازها

قبل از شروع، لازم به ذکر است که مراحل این راهنما برای کار بر روی سروری با مشخصات زیر آزمایش و تایید شده است:

• توزیع: Canonical، Ubuntu Server Pro، 22.04 LTS، amd64 Jammy image ساخته شده در 16/05/2023
• معماری CPU: x86_64 (این راهنما از CPU های مبتنی بر ARM پشتیبانی نمی کند)
• AMI: ami-0702b27a97d5bbcba
• نوع نمونه: t2.medium (حافظه 4 گیگابایت)
• فضای ذخیره سازی: 20 گیگابایت

لطفاً توجه داشته باشید که اگرچه مراحل معمولاً باید روی سرورهایی با مشخصات متفاوت کار کنند، این راهنما نمی‌تواند نتایج یکسانی را برای پیکربندی‌های دیگر یا معماری‌های CPU تضمین کند. همیشه اطمینان حاصل کنید که سرور شما الزامات نرم افزاری را که در حال نصب آن هستید برآورده می کند.

محیط خود را با متغیرهای زیر تنظیم کنید:

version=v1.15.11
domain=your.example.com

مرحله 1: Docker را نصب کنید

ما از Docker برای نصب خود استفاده خواهیم کرد. اگر هنوز 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

مرحله 3: محیط خود را پیکربندی کنید

پس از نصب 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

مرحله 4: محیط 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/
  • کاربر: پاس
  • فهرست راهنما: /
• مشاهده نقشه ها
  • https://map-storage.YOUR.EXAMPLE.COM/maps
• بازی
  • https://play.YOUR.EXAMPLE.COM/_/global/map-storage.YOUR.EXAMPLE.COM/map/map.tmj

کار آینده

• Jitsi را برای قابلیت های ویدئو کنفرانس ادغام کنید
• منطقه زمانی صحیح را برای عملیات سرور تنظیم کنید

به یاد داشته باشید، نصب و راه اندازی WorkAdventure تنها آغاز راه است. از کاوش و ایجاد دفتر مجازی منحصر به فرد خود لذت ببرید!