setzen

?????? adalah kanvas kolaboratif multipemain di mana Anda menempatkan ubin di dunia yang terdiri dari sejuta 'trixels'. Ini adalah remix dari Eksperimen R/Place April Mop Reddit.

Anda dapat menemukan demo di setzen.leifgehrmann.com

Server

Setzen secara eksklusif menggunakan model aplikasi AWS Serverless.

Penyebaran

Dalam panduan ini kami menggunakan AWS Sam Cli untuk menggunakan aplikasi.

Menginstal CLI

Amazon memiliki panduan mereka sendiri untuk memasang AWS Sam Cli.

Tetapi jika Anda telah memasang Docker, Anda dapat menggunakan Dockerfile tanpa memasang AWS Sam Cli di mesin host Anda.

 $ cd server
$ make build

Setelah gambar dibangun, Anda akan dapat memulai shell menggunakan perintah berikut.

 $ make aws-shell

Kredensial

Setelah Anda berada di shell interaktif, Anda perlu mengkonfigurasi AWS-CLI sehingga memiliki kredensial yang benar. Instruksi ini akan memandu Anda tentang cara membuat pengguna dengan akses terprogram. Setelah aplikasi digunakan, direkomendasikan untuk mencabut kredensial. Pada dasarnya, siapa pun yang memiliki kredensial ini dapat nuklir akun Anda, jadi berhati -hatilah. (Saya tidak tahu benar -benar jika ini adalah bagaimana Anda seharusnya menggunakan CloudFormation, tetapi itu benar -benar tidak terasa aman.?)

1. Di konsol AWS, navigasikan ke IAM dan buat pengguna baru: https://us-east-1.console.aws.amazon.com/iam/home#/users$new?step=details
2. Untuk langkah "detail":
   • Masukkan nama pengguna. (Contoh: setzen )
   • Pilih "Kunci Akses - Akses Programatik" sebagai jenis akses AWS.
   • Lanjutkan ke langkah "Izin".
3. Untuk langkah izin:
   • Klik "Buat Grup":
     • Masukkan nama grup. (Contoh: Setzen )
     • Di bawah kebijakan, periksa kebijakan izin berikut:
       • "Iamfullaccess"
       • "Amazons3fullaccess"
       • "Amazondynamodbfullaccess"
       • "AmazonAPigateWayAdministrator"
       • "Awscloudformationfullaccess"
       • "Awslambda_fullaccess"
     • Klik "Buat Grup".
   • Lanjutkan ke langkah "Tag".
4. Secara opsional menambahkan tag untuk membantu mengingat detail tentang pengguna IAM ini. Lanjutkan ke langkah "tinjauan".
5. Konfirmasikan detailnya dan lanjutkan ke langkah berikutnya.
6. Pastikan untuk menyalin "ID Kunci Akses" dan "Kunci Akses Rahasia" dan menyimpannya di lokasi yang aman. Setelah langkah ini, jika Anda lupa menyalin kredensial, Anda perlu menghapus dan membuat ulang pengguna.

Dengan kredensial, Anda sekarang dapat mengonfigurasi dengan menjalankan aws configure dan memasok kredensial di prompt.

 $ 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]: 

Deploy yang dipandu

Akhirnya, Anda dapat menggunakan aplikasi menggunakan sam deploy .

 $ sam deploy --guided

Pertama kali Anda menggunakan, Anda akan diminta untuk beberapa konfigurasi penyebaran.

• Nama Stack (Contoh: setzen-websockets-app )
• Wilayah AWS
• Parameter (nama tabel DynamoDB)
• Konfirmasi perubahan sebelum digunakan (Y disarankan)
• Izinkan Sam Cli IAM Penciptaan (Y disarankan)
• Nonaktifkan rollback (n direkomendasikan)
• Simpan argumen ke file konfigurasi (y disarankan)
• File Konfigurasi SAM
• Lingkungan konfigurasi SAM

Setelah selesai, Anda akan melihat di output Websocketuri yang digunakan. Catat ini untuk nanti saat menyiapkan klien.

Menguji 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":[]}}

Klien

Di konsol, ubah ke direktori client .

Dengan NPM terpasang, jalankan perintah berikut:

Instal dependensi

 $ npm install

Untuk mengonfigurasi

SETZEN_WEBSOCKET_URL adalah satu -satunya variabel yang harus ditentukan agar aplikasi berfungsi. Sisa detailnya hanyalah presentasi, tetapi berguna jika Anda ingin menyesuaikan halaman info.

 $ 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'

Untuk melihat

 $ npm run build
$ npm run preview

Untuk mengembangkan

 $ npm run dev

Atribusi

Kode Websocket awalnya berdasarkan aplikasi sederhana-websockets-chat-app.