setzen

؟؟؟؟؟؟ هي لوحة تعاونية متعددة اللاعبين حيث تضع بلاطات على الكرة الأرضية التي تتكون من مليون "ثربال". إنها ريميكس لتجربة Reddit's April Fools R/Place.

يمكنك العثور على عرض تجريبي في setzen.leifgehrmann.com

الخادم

يستخدم Setzen حصريًا نموذج تطبيق AWS Serverless.

النشر

في هذا الدليل ، نستخدم AWS SAM CLI لنشر التطبيق.

تثبيت CLI

لدى Amazon دليلها الخاص لتثبيت AWS SAM CLI.

ولكن إذا قمت بتثبيت Docker ، فيمكنك استخدام Dockerfile دون تثبيت AWS Sam Cli على جهاز المضيف الخاص بك.

 $ cd server
$ make build

بمجرد إنشاء الصورة ، ستتمكن من بدء تشغيل قذيفة باستخدام الأوامر التالية.

 $ make aws-shell

أوراق اعتماد

بمجرد أن تكون في القشرة التفاعلية ، ستحتاج إلى تكوين AWS-Cli بحيث يكون لها بيانات الاعتماد الصحيحة. ستوجهك هذه الإرشادات حول كيفية إنشاء مستخدم مع وصول برنامجي. بمجرد نشر الطلب ، يوصي بإلغاء بيانات الاعتماد. في الأساس ، يمكن لأي شخص لديه أوراق الاعتماد هذه أن يذكر حسابك ، لذا كن حذرًا جدًا. (لا أعرف حقًا ما إذا كان من المفترض أن تستخدم CloudFormation ، لكنها في الحقيقة لا تشعر بالأمان.؟)

1. في وحدة التحكم AWS ، انتقل إلى IAM وإنشاء مستخدم جديد: https://us-east-1.console.aws.amazon.com/iam/home#/users$new؟step=details
2. لخطوة "التفاصيل":
   • أدخل اسم المستخدم. (مثال: setzen )
   • حدد "مفتاح الوصول - الوصول البرمجي" كنوع AWS Access.
   • انتقل إلى خطوة "الأذونات".
3. لخطوة الأذونات:
   • انقر فوق "إنشاء مجموعة":
     • أدخل اسم المجموعة. (مثال: Setzen )
     • تحت السياسات ، تحقق من سياسات الإذن التالية:
       • "iamfullaccess"
       • "Amazons3FullAccess"
       • "Amazondynamodbfullaccess"
       • "AmazonApiGateWayAdministrator"
       • "AwsCloudFormationFullAccess"
       • "Awslambda_fullaccess"
     • انقر فوق "إنشاء مجموعة".
   • انتقل إلى خطوة "العلامات".
4. إضافة اختياريا علامات للمساعدة في تذكر التفاصيل حول مستخدم IAM هذا. انتقل إلى خطوة "المراجعة".
5. قم بتأكيد التفاصيل وانتقل إلى الخطوة التالية.
6. تأكد من نسخ "معرف مفتاح الوصول" و "مفتاح الوصول السري" وتخزينه في موقع آمن. بعد هذه الخطوة ، إذا كنت قد نسيت نسخ بيانات الاعتماد ، فستحتاج إلى حذف المستخدم وإعادة إنشاءه.

مع بيانات الاعتماد ، يمكنك الآن تكوين aws configure وتوفير بيانات الاعتماد في المطالبات.

 $ aws configure
AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: 
Default output format [None]: 

نشر موجه

أخيرًا ، يمكنك نشر التطبيق باستخدام sam deploy .

 $ sam deploy --guided

في المرة الأولى التي تنشر فيها ، سيتم مطالبتك ببعض تكوينات النشر.

• اسم المكدس (مثال: setzen-websockets-app )
• منطقة AWS
• المعلمات (اسم جداول DynamoDB)
• تأكيد التغييرات قبل النشر (يوصي Y)
• السماح لـ Sam Cli IAM Creation (يوصى بتوفير y)
• تعطيل التراجع (ينصح n)
• احفظ الوسيطات إلى ملف التكوين (يوصى به y)
• ملف تكوين SAM
• بيئة تكوين SAM

بمجرد الانتهاء ، يجب أن ترى في الإخراج WebSocketuri المنشور. حافظ على ملاحظة هذا في وقت لاحق عند إعداد العميل.

اختبار websocket

 $ cd test-wscast
$ npm install
$ npx wscat -c wss://{YOUR-API-ID}.execute-api.{YOUR-REGION}.amazonaws.com/Prod
> { "action": "sendmessage", "data": {"type": "readChunkInfo" } }
< {"type":"queue","data":{"positions":[],"colorIds":[],"times":[]}}

عميل

في وحدة التحكم ، قم بتغيير دليل client .

مع تثبيت NPM ، قم بتشغيل الأوامر التالية:

تثبيت التبعيات

 $ npm install

لتكوين

SETZEN_WEBSOCKET_URL هو المتغير الوحيد الذي يجب تعريفه للتطبيق للعمل. بقية التفاصيل مجرد عرضية ، ولكنها مفيدة إذا كنت ترغب في تخصيص صفحة المعلومات.

 $ export SETZEN_WEBSOCKET_URL='wss://xxxxxxxxxx.execute-api.xx-xxx-x.amazonaws.com/Prod'
$ export SETZEN_WEBAPP_HOST='example.com'
$ export SETZEN_CONTACT_EMAIL='[email protected]'
$ export SETZEN_CONTACT_URL='https://example.com/admin'
$ export SETZEN_CONTACT_ISSUES_URL='https://example.com/setzen/issues'
$ export SETZEN_CONTACT_PROJECT_URL='https://example.com/setzen'

لعرض

 $ npm run build
$ npm run preview

للتطور

 $ npm run dev

الإسناد

رمز WebSocket في الأصل يعتمد على تطبيق Websockets-Chat-App البسيط.