Accelerator Unity adalah agen proxy caching yang menyimpan salinan aset impor tim untuk mempercepat kerja tim. Tujuan dari akselerasi adalah untuk membantu tim mengurangi waktu iterasi. Pengkoordinasian Accelerator berbagi aset ketika tim Anda bekerja pada jaringan lokal yang sama sehingga Anda tidak perlu mengandalkan bagian proyek Anda. Ini dilakukan melalui kemampuan Editor Unity Aset Impor Pipeline v2. Opsional, Accelerator juga dapat digunakan dengan Advanced untuk berbagi aset sumber Collaborate, yang secara signifikan mengurangi waktu unduh dari layanan Layanan cloud-hosted Unity yang menyediakan cara sederhana untuk tim untuk menyimpan, berbagi, dan berkontribusi pada proyek Unity mereka. More info
Lihat di Glossary.
Ketika Anda menginstal Accelerator di jaringan lokal Anda, Unity Editor (versi 2019.3 atau lebih tinggi; lihat Unity Editor requirements di bawah) berkomunikasi dengan itu untuk menyimpan dan mengambil aset yang dibutuhkan anggota tim lain, telah berubah, atau dibangun. Accelerator menyimpan salinan sementara aset ini untuk menghindari membuang waktu dan pengambilan bandwidth atau mengubahnya.
Instal Accelerator pada setiap jaringan tim Anda secara teratur bekerja. Anda harus memiliki mesin yang berjalan di jaringan lokal Anda yang dapat menghosting Accelerator. Ketika memilih host, pertimbangkan persyaratan berikut:
Proyek Unity Anda harus menggunakan versi 2019.3 atau lebih tinggi dari Mesin Unity.
Jika Anda tidak memiliki Tim Unity Advanced, Anda dapat mengunduh dan menginstal Unity Accelerator langsung dan membatalkan token pendaftaran selama instalasi:
Note: Jika menginstal Accelerator pada sistem Linux, lihat Verifikasi versi Accelerator Anda.
Anda juga dapat menginstal accelerator melalui Docker Hub.
Di setiap platform, Anda dapat menjalankan installer dari baris perintah. Jika Anda mengeksekusi installer dengan argumen --help
, itu menampilkan berbagai pilihan yang tersedia. Untuk menjalankan instalasi penuh tanpa prompt, Anda harus menyediakan nilai-nilai untuk berikut:
--storagedir
menetapkan direktori untuk Accelerator untuk menyimpan file dan konfigurasi.--registration-token
menentukan token yang diberikan dalam setelah membuat Accelerator. Ini diperlukan untuk menggunakan Accelerator dengan Collaborate.--mode
tidak diinginkan untuk instalasi otomatis yang tidak boleh query apa pun. Ini menggunakan nilai default, atau nilai dari bendera opsi lain yang disediakan.Contents/MacOS/installbuilder.sh
).Saat memasang Accelerator, langkah akhir wizard setup menampilkan alamat IP dan Pelabuhan untuk merujuk pada Editor Anda, dalam format berikut:
[IP]:[Port]
Untuk mengkonfigurasi Editor Anda untuk menggunakan Accelerator sebagai versi pipa Aset 2 Cache ServerAplikasi mandiri yang dapat Anda jalankan di komputer lokal Anda yang menyimpan data aset impor untuk mengurangi waktu yang dibutuhkan untuk mengimpor aset. More info
Lihat di Glossary, ikuti langkah-langkah ini:
Anda dapat memilih prefix namespace yang berbeda dari default, jika Anda ingin memastikan isolasi dari proyek lain. Anda juga dapat mengunggah atau mengunduh secara individual sesuai kebutuhan. Misalnya, Anda mungkin ingin sistem build hanya memiliki mengunggah diaktifkan, dan editor pengembang hanya memiliki download diaktifkan. Perhatikan opsi TLS / SSL hanya fitur dalam versi editor dari 2020. 1 ke atas dan akselerator harus dikonfigurasi untuk TLS juga.
Dalam tampilan editor utama, Anda dapat memeriksa konektivitas accelerator dengan melihat status bar di kanan bawah (hanya dalam versi editor dari 2020.1 onward):
Jika Anda ingin, Anda dapat mengkonfigurasi akselerator untuk digunakan melalui pengaturan Global, yang akan digunakan secara default untuk semua proyek kecuali overridden oleh pengaturan proyek. Untuk mengkonfigurasi pengaturan global, pilih item menu Edit > Preferences…:
Sebuah wadah disediakan di Docker Hub di https://hub.docker.com/repository/docker/unitytechnologies/accelerator.
Unity merekomendasikan bahwa Anda menggunakan area penyimpanan terus-menerus untuk hosting konfigurasi Accelerator dan cache. Untuk mengatur ini untuk pertama kalinya, Anda akan ingin menggunakan satu atau lebih dari variabel berikut ketika menjalankan wadah untuk pertama kalinya (beberapa contoh akan di bawah). Variabel hanya digunakan jika startup tidak menemukan file konfigurasi sehingga aman untuk dijalankan dengan mereka mengatur berjalan berturut-turut.
Variable | Usage |
---|---|
COLLAB_REGISTRATION_TOKEN | Accelerate |
DISABLE_USAGE_STATS | Set untuk benar untuk menonaktifkan statistik penggunaan - meninggalkan statistik penggunaan diaktifkan dapat membantu meningkatkan fitur Accelerator dan kinerja dengan memberikan umpan balik berharga Unity. |
USER | Nama pengguna untuk dashboard lokal, built-in. |
PASSWORD | Kata sandi untuk dashboard lokal, built-in. |
CERT_HOSTNAME | Nama host untuk digunakan untuk dukungan TLS. Ini digunakan untuk pengalihan, dll. dan berjalan bersama dengan CERT_PEM dan KEY_PEM di bawah ini. |
CERT_PEM | Jalan ke cert.pem untuk digunakan untuk dukungan TLS. Jika Anda mengatur CERT_HOSTNAME tetapi tidak mengatur CERT_PEM, <persist_dir> /cert.pem akan diasumsikan. |
KEY_PEM | Jalan ke kunci.pem untuk digunakan untuk dukungan TLS. Jika Anda mengatur CERT_HOSTNAME tetapi tidak mengatur KEY_PEM, <persist_dir> /key.pem akan diasumsikan. |
Misalnya, untuk memulai dan mendaftar untuk digunakan dengan layanan Collaborate, Anda mungkin menjalankan sesuatu seperti ini:
$ docker run --rm -ti -v "${PWD}/agent:/agent" -e 'COLLAB_REGISTRATION_TOKEN=ft0bJvbRD' unitytechnologies/accelerator:latest
Untuk menimpa pengaturan TLS, terus dengan contoh di atas, pastikan Anda memiliki cert.pem dan kunci Anda. pem di jalur /agen ditentukan dan kemudian menyertakan CERT_HOSTNAME seperti ini:
$ docker run --rm -ti -v "${PWD}/agent:/agent" -e 'CERT_HOSTNAME=myhostname.com' -e 'COLLAB_REGISTRATION_TOKEN=ft0bJvbRD' unitytechnologies/accelerator:latest
Anda juga dapat mengatur variabel lingkungan dari accelerator biasanya akan mengenali. Lihat unity-accelerator --all-help
dan cari opsi yang menunjukkan Default: $SOME_VARIABLE
. Ada dua bahwa wadah akan diatur jika Anda tidak:
variable | usage |
---|---|
UNITY_ACCELERATOR_PERSIST | Default kontainer adalah / agen. Ini adalah direktori di mana unity-accelerator.cfg disisi serta data yang bertahan lainnya (cachedir mungkin berbeda). |
UNITY_ACCELERATOR_LOG_STDOUT | Default kontainer benar. Ini, jika benar, akan output log ke stdout hanya; palsu jika Anda ingin file log sebenarnya ditulis dalam direktori yang bertahan. |
Kami menandatangani gambar docker kami sehingga kami sangat menyarankan Anda mengaktifkan Konten Docker Trust:
$ export DOCKER_CONTENT_TRUST=1
Biasanya, Anda harus dapat menjalankan Accelerator seperti berikut:
$ docker run -p 80:80 -p 443:443 -p 10080:10080 -v "${PWD}/agent:/agent" unitytechnologies/accelerator:latest
Login Jika Anda ingin memilih lokasi yang berbeda untuk di mana Accelerator akan menyimpan konfigurasi dan artefak cache, Anda mungkin memilih untuk menyediakan nilai konfigurasi variabel lingkungan tambahan seperti ini:
$ docker run -p 80:80 -p 443:443 -p 10080:10080 -v "${PWD}/agent:/mnt/another_spot" -e "UNITY_ACCELERATOR_PERSIST=/mnt/another_spot" -e "UNITY_ACCELERATOR_DEBUG=true" unitytechnologies/accelerator:latest
Untuk mengatur username dan password untuk dashboard lokal, Anda dapat menggunakan variabel lingkungan PENGGUNA dan PASSWORD:
$ docker run -p 80:80 --env PASSWORD=[PASSWORD] --env USER=[USERNAME] unitytechnologies/accelerator:latest
Berikut ini adalah nilai default untuk port yang digunakan oleh Unity Accelerator: 80, 443, 10080, 10443.
Accelerator memberikan manfaat tambahan dengan Advanced:
Jika Anda memiliki Tim Unity Advanced, salah satu Pemilik atau Manajer Organisasi Anda dapat membuat Accelerator dari langkah-langkah berikut ini:
Note: Jika menginstal Accelerator pada sistem Linux, lihat Verifikasi versi Accelerator Anda.
Ketika digunakan dengan Advanced, setiap Accelerator menerima sertifikat keamanannya sendiri untuk membuktikannya memiliki izin untuk mengakses Organisasi Anda. Sebelum mengunggah Accelerator atau mengunduh konten apa pun, Editor Unity membuat permintaan menggunakan SSL/TLS untuk menghubungkan dengan Accelerator dan memverifikasi keasliannya. Ketika Editor Unity menemukan dan terhubung ke Accelerator, alih-alih melewati token pengguna Unity normal, mereka menerima token khusus dari layanan Identitas Unity. Token ini memverifikasi identitas pengguna dan akses ke satu proyek di dalam Organisasi Anda, sehingga melindungi akses ke organisasi dan proyek lain sambil menggunakan Accelerator.
Atau Anda dapat menyediakan rincian konfigurasi Accelerator Cache Server menggunakan perintah baris argumen ketika meluncurkan Editor Unity.
Untuk menentukan bahwa Anda ingin menggunakan Accelerator Cache Server, gunakan argumen -EnableCacheServer
, dan untuk menentukan alamat dan nomor port, gunakan -cacheServerEndpoint Address:Port
, mengganti Alamat dan Pelabuhan dengan rincian Cache Server Anda.
Catatan: Server Cache Accelerator mengharuskan proyek Anda menggunakan Asset Database V2 (ADB2). Anda dapat memaksa peningkatan ADB2 ketika meluncurkan Unity dari baris perintah dengan menggunakan argumen -adb2
.
Lihat perintah baris argumen untuk informasi lebih lanjut.
Accelerator memiliki dashboard built-in untuk pemantauan cepat dan perubahan konfigurasi.
Lihat bagian Command Line Tools untuk informasi tentang cara mencari tahu apa URL dasbor Anda; meskipun jika Anda tahu ip dan port accelerator Anda hanya dapat menggunakan http://ip:port/dashboard dan accelerator akan menangani redirect yang diperlukan. Untuk pemantauan metrik penuh melihat Accessing Accelerator metrik langsung dan konfigurasi penuh Accelerator tersedia melalui file akselerator.cfg.
Jika Anda adalah tim Unity pengguna tingkat lanjut, Anda dapat memantau metrik Accelerator dari . Ini hanya berlaku untuk aset sumber, dan tidak berlaku untuk aset yang dihasilkan (diimporkan).
Untuk melihat ringkasan Accelerator proyek Anda, pilih proyek tersebut, lalu pilih Collaborate > Accelerators dari bar navigasi kiri. Dalam menu ini, Anda dapat melihat informasi berikut:
Property | Description |
---|---|
Name | Nama yang Anda berikan ketika Anda membuat Accelerator. |
Avg. Efficiency | Rata-rata efficiency dari Accelerator selama 24 jam terakhir. |
Editors | Jumlah Editor Unity yang terhubung ke Accelerator. |
Latest Activity | Penggunaan terbaru dari Accelerator. |
Status | Accelerator dapat berada di salah satu negara berikut: - Available menunjukkan bahwa Accelerator tidak diinstal atau terdaftar dengan layanan Collaborate. - Ready menunjukkan bahwa Accelerator terdaftar dengan layanan Collaborate, tetapi tidak ada editor Unity terhubung ke dalamnya. - In use menunjukkan bahwa Editor Unity terhubung, atau baru-baru ini terhubung ke Accelerator. - Idle menunjukkan bahwa Editor Unity telah menggunakan Accelerator sebelumnya, tetapi tidak ada aktivitas baru-baru ini. - Not Listening menunjukkan bahwa Accelerator tidak dapat terhubung ke port yang dikonfigurasi (mungkin besar karena layanan lain sudah menggunakannya). - Disconnected menunjukkan bahwa Accelerator tidak lagi terhubung ke layanan untuk pelaporan penggunaan, atau menerima perubahan konfigurasi. |
Enabled | Menunjukkan apakah Editor Unity dapat menemukan dan mencoba untuk menggunakan Accelerator. Editor Unity tidak menggunakan Accelerator dinonaktifkan, terlepas dari apakah mereka berjalan. |
Klik Details untuk Accelerator untuk melihat informasi mendalam berikut tentang penggunaannya. Data ini diperbarui setiap 10 menit.
Ini menunjukkan kinerja rata-rata Akselerator selama 24 jam terakhir. Nilai berkisar dari 0 hingga 100, mengukur persentase unduhan konten yang disediakan secara lokal dari Accelerator, daripada jarak jauh dari layanan Collaborate. Nilai 0 menunjukkan bahwa Accelerator tidak aktif membantu dengan unduhan konten. Nilai 100 menunjukkan bahwa Accelerator menyediakan semua unduhan konten.
Secara berkala, ruang penyimpanan Accelerator untuk menyimpan aset baru. Ketika itu, dashboard melaporkan jumlah byte yang dialokasikan untuk aset yang lebih tua yang Accelerator dihapus dari penyimpanan lokal.
Note: Ini adalah operasi normal untuk membantu menjaga Accelerator yang sehat. Namun, jika nilai ini tampaknya merugikan mempengaruhi efisiensi Accelerator, Anda mungkin perlu menambahkan lebih banyak ruang penyimpanan untuk mengakomodasi penggunaan tim Anda. Idealnya, sistem file menjalankan Accelerator harus menggunakan hard drive solid-state dengan ruang disk gratis yang cukup untuk rumah semua file dalam versi terbaru dari proyek aktif, tetapi ini bukan persyaratan. Jika penyimpanan yang tidak memadai tersedia, efisiensi keseluruhan penurunan Accelerator.
Mendistribusikan tim mungkin memiliki kontributor lokal yang bekerja dengan Accelerator, serta kontributor jarak jauh menggunakan layanan Collaborate. Dalam kasus ini, Accelerator mendengarkan peristiwa penerbitan jarak jauh, dan secara proaktif mengunduh konten yang terkena bagi pengguna di jaringan lokal.
Ketika Anda menggunakan Accelerator, laporan pada keseluruhan jumlah byte yang telah diminta dan diunduh dari layanan Collaborate jarak jauh, daripada yang telah disampaikan dari jaringan lokal. Lebih banyak ketepatan yang disampaikan secara lokal lebih baik untuk tim Anda, karena tempatnya kurang beban di gerbang jaringan Anda.
Accelerator melacak bandwidth ketika memberikan aset yang disimpan secara lokal daripada mengunduhnya dari layanan Collaborate, dan melaporkan perbedaan waktu Editor Unity akan menunggu aset unduhan secara jarak jauh seiring waktu yang disimpan.
Note: metrik yang disebutkan hanya berlaku untuk aset sumber. Mereka tidak berlaku untuk aset yang dihasilkan (diimporkan).
Jika Anda tidak menggunakan Tim Unity Advanced, setiap Accelerator host Laporan metrik Prometheus sebagai /metrics
, yang dapat Anda query dari jaringan lokal. Berikut adalah daftar lengkap metrik yang dapat Anda akses:
Metric | Description |
---|---|
process_resident_memory_bytes |
Jumlah memori yang digunakan oleh Accelerator. |
uta_agent_sys_cpu_percent |
Jumlah CPU yang digunakan oleh sistem. |
uta_agent_sys_mem_bytes_used |
Jumlah memori yang digunakan oleh sistem. |
uta_agent_protobuf_connects |
Jumlah Editor Unity telah terhubung ke layanan untuk Pipa Impor Aset. |
uta_agent_protobuf_bytes_in |
Jumlah byte yang diterima dari Aset Impor Pipeline. |
uta_agent_protobuf_bytes_out |
Jumlah byte dikirim ke Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="0",method="get"} |
Jumlah item yang dikirim ke Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="1",method="get"} |
Jumlah kesalahan yang terjadi dari item yang dikirim ke Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="2",method="get"} |
Jumlah kesalahan namespace yang terjadi dari item yang dikirim ke Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="3",method="get"} |
Jumlah permintaan yang terbuat dari Aset Import Pipeline untuk barang-barang yang belum tersimpan. |
uta_agent_protobuf_requests{code="0",method="put"} |
Jumlah item yang diterima dari Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="1",method="put"} |
Jumlah kesalahan yang terjadi dari item yang diterima dari Aset Import Pipeline. |
uta_agent_protobuf_requests{code="2",method="put"} |
Jumlah kesalahan namespace yang terjadi dari item yang diterima dari Asset Import Pipeline. |
uta_agent_protobuf_requests{code="0",method="delete"} |
Jumlah permintaan yang terbuat dari Asset Import Pipeline untuk menghapus item. |
uta_agent_protobuf_requests{code="1",method="delete"} |
Jumlah kesalahan yang terjadi dari Asset Import Pipeline menghapus item. |
uta_agent_protobuf_requests{code="2",method="delete"} |
Jumlah kesalahan namespace yang terjadi dari permintaan untuk menghapus item dengan Aset Impor Pipeline. |
uta_agent_protobuf_requests{code="3",method="delete"} |
Jumlah permintaan untuk menghapus item yang terbuat dari Aset Impor Pipeline untuk item yang belum tersimpan. |
uta_agent_cache_bytes_evicted_unscheduled |
Jumlah baling-baling yang disohor dari cache selama lulus “tidak dijadwalkan”. Penggusuran tak terjadwal terjadi ketika menjalankan ruang disk sambil memproses permintaan. Biasanya, penggusuran latar belakang dijadwalkan harus tetap dengan permintaan, sehingga peningkatan nilai metrik ini menunjukkan server yang luar biasa. Meningkatkan CacheMinFreeBytes konfigurasi atau CacheMinFreePercent dapat membantu memberikan lebih banyak penyangga ruang gratis, atau Anda mungkin perlu meningkatkan perangkat keras yang mendasari atau menginstal akselerasi tambahan. |
uta_agent_cache_files_evicted_unscheduled |
Mirip dengan uta_agent_cache_bytes_evicted_unscheduled metrik, tetapi menghitung file yang disayangkan bukan jumlah byte. Ini mungkin metrik yang lebih mudah untuk waspada. Contoh: Peringatan ketika file metrik meningkat lebih dari 1 per detik. |
uta_agent_protobuf_cache_hits |
Jumlah permintaan Aset Import Pipeline yang disajikan dari cache. |
uta_agent_protobuf_cache_misses |
Jumlah permintaan Pipa Impor Aset yang tidak bisa dilayani dari cache. |
uta_agent_protobuf_cache_bytes_out |
Jumlah byte yang dilayani dari cache ke Aset Impor Pipeline. |
uta_agent_protobuf_cache_bytes_in |
Jumlah byte yang disimpan ke dalam cache yang diterima dari Aset Impor Pipeline. |
Unity Editor logs berguna untuk melihat informasi debugging. Untuk melihat log untuk acara Collaborate, menjalankan Editor Unity Anda (atau Hub Unity) dengan variabel lingkungan yang diatur menjadi enableCollabEventLogs=true
. Log ditandai dengan [collab-accelerator]
dapat membantu memberikan wawasan tentang kinerja Accelerator Anda.
Blok di bawah ini menunjukkan output log misalnya untuk Accelerator menggunakan Aset Import Pipeline v2. Ini tidak memerlukan enableCollabEventLogs=true
karena tidak untuk berkolaborasi.
2019-10-07T11:34:51-0700 Using Asset Import Pipeline V2.
...
2019-08-08T09:04:03-0700 Start importing Assets/Scenes/tame-the-unicorn.png guid(07a0d449dcaef4d2ba104e9d9b350de6)
2019-08-08T09:04:05-0700 Done importing asset: 'Assets/Scenes/tame-the-unicorn.png' (target hash: 'd5fddd470dd9beedcd7261b6455e436a') in 1.082988 seconds
2019-08-08T09:04:05-0700 RemoteAssetCache::AddArtifactToCacheServer - artifactKey='Guid(07a0d449dcaef4d2ba104e9d9b350de6) Importer(-1,)' Target hash='d5fddd470dd9beedcd7261b6455e436a'
Querying for cacheable assets in Cache Server:
86ac778e1a44c9143864797ddacf8cc9:Assets/New Material.mat
RemoteAssetCache - Download - Metadata - success:true, namespace:81e94844d19a16919208533e08183531, key:8d71d5006046bb9d5e4a7172eec3f3b2
RemoteAssetCache - Download - Artifact - success:true, namespace:78b2fdc254b0a4f8a4693a81bb96598a, key:de1eef03efd25a722d1500658bf19038 for asset:'Assets/New Material.mat', time elapsed: 0.005171 seconds
RemoteAssetCache - Download - Artifact - success:true, namespace:78b2fdc254b0a4f8a4693a81bb96598a, key:b19c9d64967a9691abecdb66364ae392 for extension:'Assets/New Material.mat.info', time elapsed: 0.004721 seconds
Accelerator berjalan sebagai proses latar belakang untuk setiap platform.
Buka Services Panel dengan mencari istilah "Layanan" di menu Pengaturan, atau menjalankan "_services.msc_" di dialog Run (WIN + R). Selanjutnya, cari layanan “Unity Accelerator” di daftar yang dihasilkan. Opsi untuk Stop the service atau Restart the service muncul di panel kiri.
Jalankan perintah launchctl
dari terminal untuk mengontrol layanan “com.unity.accelerator” dari utilitas LaunchControl. Untuk informasi lebih lanjut, kunjungi url https://www.launchd.info/.
Gunakan utilitas konsol service
untuk mengontrol layanan "as-accelerator". Untuk informasi lebih lanjut, kunjungi http://manpages.ubuntu.com/manpages/bionic/man8/service.8.html.
Layanan Accelerator secara otomatis memperbarui dirinya selama periode perawatan, saat ini ditetapkan untuk 01:00 - 02:00 AM waktu setempat sesuai dengan mesin yang menjalankan Accelerator. Ini hanya terjadi jika Accelerator menemukan versi yang lebih baru tersedia.
Log instalasi dan penghapusan Accelerator disimpan di direktori suhu standar sistem operasi sebagai unity-accelerator-*install.log
. Log Accelerator disimpan di direktori penyimpanan sebagai unity-accelerator.log
.
Accelerator memiliki set besar alat baris perintah yang dapat Anda gunakan untuk memecahkan masalah, mengkonfigurasi, dan hanya umumnya menggunakan satu atau lebih accelerator. Untuk kemudahan penggunaan, sebaiknya menambahkan lokasi executable akselerator ke PATH Anda. Dieksekusi dipasang di jalan yang Anda pilih saat menjalankan installer, C:\Program File\Unity\accelerator misalnya.
Alat CLI memiliki sistem bantuan yang luas; Anda dapat menjalankan unity-accelerator tanpa argumen untuk memulai:
$ unity-accelerator
Unity Accelerator v1.0.524+g96c5e18
Run on a local network to speed up transactions with Unity Services.
.....
Anda juga dapat menjalankan unity-accelerator --all-help
untuk menghasilkan semua teks bantuan untuk semua perintah dalam satu arah. Ini mungkin terbaik untuk pipa output melalui output kurang atau redirect ke file teks untuk membaca.
Ketika bekerja pada akselerasi tertentu, untuk mengonfigurasinya misalnya, yang terbaik untuk mengubah direktori kerja Anda sama seperti di mana file unity-accelerator.cfg
. Anda juga dapat mengatur variabel lingkungan UNITY_ACCELERATOR_PERSIST
ke direktori itu, atau Anda dapat mencoba untuk diingat untuk selalu menggunakan opsi --persist <dir>
, tetapi sebagian besar menemukan perubahan direktori kerja yang paling mudah.
Satu set alat yang agak umum digunakan adalah alat dashboard:
$ unity-accelerator dashboard password newaccount
Password: ****
Again: ****
$ unity-accelerator dashboard list
admin
newaccount
$ unity-accelerator dashboard url
http://172.18.37.249:8080/dashboard/
Alat akhir itu, dashboard url
, berguna untuk mengetahui apa url untuk menempatkan di browser Anda untuk mengunjungi dashboard built-in.
Anda dapat mengkonfigurasi beberapa accelerator untuk mencerminkan data cache yang sama jika diinginkan. Anda mungkin ingin memiliki dua akselerator cermin yang berjalan di jaringan yang sama untuk ketersediaan tinggi - jika satu crash, memiliki kegagalan perangkat keras, atau perlu pemeliharaan untuk alasan apa pun, akselerator lain dapat mengkompensasi. Anda juga mungkin mencerminkan server cache cermin yang jauh dari satu sama lain, misalnya kantor utama mungkin mencerminkan datanya ke kantor cabang, menyediakan salinan data yang tersimpan untuk digunakan di kantor cabang juga.
Sekarang, fitur cermin hanya memberikan kemampuan data yang keluar, juga dikenal sebagai “push” atau “forwarding”. Anda dapat mendorong / menaikkan beberapa akselerator, atau bahkan rantai mereka: Pengiriman ke B, dengan pengiriman B ke C, dan bahkan C mengirimkan kembali ke A. Anda tidak perlu khawatir tentang rantai melingkar; item saat dicap sehingga akselerasi penerima akan mengabaikan barang masuk yang tidak lebih baru daripada apa yang sudah dimiliki.
Mari kita berjalan melalui contoh di mana accelerator A memiliki ip:port 1.1.1.1:1111 dan accelerator B adalah 2.2.2.2:2222. Katakanlah keduanya tidak memiliki data untuk memulai, jadi mari kita masukkan item ke dalam A dan perhatikan bahwa itu tidak di B.
$ echo test1 | unity-accelerator cache put 1.1.1.1:1111 namespace1 key1
$ unity-accelerator cache get 1.1.1.1:1111 namespace1 key1
test1
$ unity-accelerator cache get 2.2.2.2:2222 namespace1 key1
key not found
Sekarang mari kita mengkonfigurasi A untuk maju ke B. Kami melakukan ini dengan mengubah konfigurasi A, jadi masuk ke mesin yang menjalankan accelerator A, mematikan akselerator dan:
# Shutdown Accelerator A
$ cd <directory where unity-accelerator.cfg is>
$ unity-accelerator config set ProtobufForwardPuts protobuf:2.2.2.2:2222
# Start Accelerator A back up
Sekarang kita harus dapat menempatkan item lain ke cache A dan melihatnya diteruskan ke B.
$ echo test2 | unity-accelerator cache put 1.1.1.1:1111 namespace2 key2
$ unity-accelerator cache get 1.1.1.1:1111 namespace2 key2
test2
$ unity-accelerator cache get 2.2.2.2:2222 namespace2 key2
key not found
# It will take up to a minute before the forwarding occurs, due to how the algorithm works with batching, etc. But within a minute or two you should see...
$ unity-accelerator cache get 2.2.2.2:2222 namespace2 key2
test2
Namun, ini hanya mencakup data baru (yang baru item dimasukkan ke dalam accelerator A akan diteruskan ke accelerator B) tetapi tidak mencakup data yang ada. Dalam contoh kami, item pertama masih belum di accelerator B.
$ unity-accelerator cache get 2.2.2.2:2222 namespace1 key1
key not found
Untuk menutupi kasus ini, dan dalam kasus di mana Anda hanya ingin meneruskan semua data satu kali (dapat berguna ketika beralih dari satu akselerator ke yang baru) Anda dapat menggunakan alat baris perintah "push":
$ unity-accelerator cache push 1.1.1.1:1111 2.2.2.2:2222
{"msg":"push completed", "destination":"2.2.2.2:2222", "namespaces":2, "keys":2, "bytes":12, "supercededs":1, "errors":0, "elapsed":"44.054078ms"}
$ unity-accelerator cache get 2.2.2.2:2222 namespace1 key1
test1
Alat push akan mengirimkan permintaan untuk akselerator pertama dan memintanya untuk mengirim semua data ke akselerator kedua. Ketika dilakukan, akselerator pertama akan mengirim kembali respons "push selesai" secara rinci seperti apa yang dilakukan.
Ada opsi konfigurasi canggih yang dapat Anda penelitian dengan menjalankan unity-accelerator config help | less
dan mencari Maju. Anda dapat menentukan koncurrency penerusan, ukuran antrian, penanganan kesalahan, dll.
Juga dicatat bahwa Anda mungkin ingin mengubah nilai konfigurasi untuk PemeliharaanStart dan PemeliharaanDuration setiap akselerator cermin sehingga mereka tidak semua shutdown untuk pemeliharaan pada saat yang sama.
Jika Anda telah menginstal Accelerator, tetapi beberapa Editor Unity tidak menggunakannya, beberapa hal dapat menyebabkan masalah ini. Opsi pemecahan masalah berikut dapat membantu Anda memperbaikinya:
Setiap kontributor proyek harus menggunakan versi Editor 2019.3 atau lebih tinggi untuk menggunakan Accelerator.
Pastikan Accelerator berjalan di jaringan area lokal yang sama sebagai kontributor proyek mengalami masalah. Accelerator tidak mempengaruhi kontributor yang bekerja jauh.
Periksa apakah mesin mengalami masalah dapat mencapai Accelerator. Jika Anda menggunakan Tim Unity Advanced, ikuti langkah-langkah ini untuk mengakses halaman kesehatan Accelerator di browser Anda:
Jika Anda tidak menggunakan Tim Unity Advanced, masukkan alamat IP host Accelerator ke jalur URL berikut untuk menampilkan halaman kesehatannya:
[AcceleratorIP]:[AcceleratorPort]/api/agent-health
Jika tes gagal, pastikan semua host dan firewall jaringan memungkinkan akses ke alamat IP dan port Accelerator (TCP). Anda mungkin perlu berkoordinasi dengan administrator jaringan Anda untuk memungkinkan akses ke port ini.
Jika Anda menggunakan Tim Unity Lanjutan, verifikasi bahwa Accelerator dikonfigurasi untuk proyek yang dimaksud. Navigasi ke proyek di, dan pilih Collaborate > Accelerator dari bilah navigasi kiri. Anda harus melihat Accelerator yang terdaftar untuk proyek tersebut.
Untuk instalasi Accelerator pada sistem Linux, semua Linux executables memiliki file tanda tangan yang dapat Anda verifikasi untuk memastikan bahwa tidak ada entitas jahat yang telah terganggu dengan versi Accelerator yang diunduh. Anda dapat memverifikasi file tanda tangan dengan versi terpercaya GnuPG. Kunci di bawah tanda-tanda rilis saat ini. Blok kunci publik dengan kunci tersedia di .
pub rsa4096 2019-12-02
Key fingerprint = 9BC4 B04D F2E8 74E5 64AA 47E7 6D44 3B8B 002C F61F
uid Unity Technologies ApS (Accelerator signing key) <sst-ops@unity3d.com>
Untuk mengunduh kunci ke toko GPG Anda, gunakan salah satu perintah berikut:
$ gpg --keyserver https://collab-accelerator.cloud.unity3d.com/ --search-key "sst-ops@unity3d.com"
$ gpg --keyserver https://collab-accelerator.cloud.unity3d.com/ --recv-key 9BC4B04DF2E874E564AA47E76D443B8B002CF62F
Untuk memeriksa versi Accelerator yang Anda instal asli dan tidak dimodifikasi, verifikasi tanda tangan file.
File instalasi Accelerator dilengkapi dengan file tanda tangan yang tersedia pada https://storage.googleapis.com/unity-accelerator-prd/unity-accelerator-installer.sig. Gunakan file tanda tangan ini untuk memverifikasi installer Accelerator:
$ gpg --verify unity-accelerator-installer.sig unity-accelerator-linux-x64-installer.run
Sebelum mempercayai kunci, bandingkan sidik jari dengan apa yang ditunjukkan pada tombol yang ditempa atau tidak dipercaya. Setelah mempercayai kunci, Anda akan melihat sesuatu seperti:
gpg: Signature made Thu Jan 16 12:29:14 2020 PST
gpg: using RSA key 9BC4B04DF2E874E564AA47E76D443B8B002CF61F
gpg: Good signature from "Unity Technologies ApS (Accelerator signing key) <sst-ops@unity3d.com>" [ultimate]
Ini berarti tanda tangan valid dan bahwa Anda percaya kunci ini.
Jika Anda tidak memiliki kunci distribusi yang benar, output dari perintah di atas akan terlihat sebagai berikut:
gpg: Signature made Thu Jan 16 12:29:14 2020 PST
gpg: using RSA key 9BC4B04DF2E874E564AA47E76D443B8B002CF61F
gpg: Can't check signature: No public key
Dalam hal ini, Anda harus mendapatkan kunci menggunakan instruksi di atas.
Jika Anda memiliki salinan kunci dengan tanda tangan yang valid, tetapi kuncinya tidak ditandai sebagai tepercaya atau kunci adalah kemarahan, output akan terlihat sebagai berikut:
gpg: Signature made Thu Jan 16 12:29:14 2020 PST
gpg: using RSA key 9BC4B04DF2E874E564AA47E76D443B8B002CF61F
gpg: Good signature from "Unity Technologies ApS (Accelerator signing key) <sst-ops@unity3d.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: 9BC4 B04D F2E8 74E5 64AA 47E7 6D44 3B8B 002C F61F
Jika kunci telah ditempa, Anda harus memverifikasi sidik jari menggunakan file tanda tangan. Jika kunci belum ditandai sebagai tepercaya, editnya untuk menandainya sebagai tepercaya. Untuk informasi lebih lanjut, lihat https://www.gnupg.org/gph/en/manual/x334.html.
Untuk membantu mengenai Accelerator dengan Tim Unity, atau kirimkan tiket bantuan dari . Untuk mengirimkan tiket untuk proyek Unity Teams Advanced, pilih proyek Anda, kemudian pilih Collaborate > Support dari bar navigasi kiri.
Untuk membantu mengenai Accelerator dengan Asset Import Pipeline, silakan kunjungi.