Pindahkan Anda Proyek ke sistem kontrol versi lain
Collaborate pemecahan masalah tips

Accelerator

Overview

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.

Accelerator overview
Gambaran keseluruhan Accelerator

Contents

Menginstal Accelerator

Requirements

Persyaratan hosting lokal

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:

  • Host lokal harus menjalankan salah satu sistem operasi berikut:
    • Linux (Ubuntu 16.04, Ubuntu 18.04, atau CentOS 7)
      Untuk Linux Anda harus menginstal Acccelerator sebagai pengguna akar.
    • Windows Server 2008R2 / Windows 7 atau lebih tinggi (64bit)
    • Mac OS X 10.12 atau lebih tinggi (64bit)
  • Host lokal harus memiliki ruang penyimpanan lokal yang cukup untuk menghosting sebagian besar file proyek Anda, sebaiknya pada drive solid-state terpisah dari drive yang menghosting sistem operasi Anda.
  • Host lokal harus memiliki banyak memori yang cukup terjangkau. Minimal harus 2GB RAM, tetapi jika lebih banyak memori tersedia itu akan digunakan oleh sistem operasi untuk buffer item cached, menghasilkan kinerja yang lebih tinggi untuk item yang sering diakses. Rekomendasi Biasa adalah 32GB RAM.
  • Host lokal harus dilampirkan ke jaringan yang sama dengan tim Anda, atau secara lokal dapat diterima dengan kebijakan firewall yang sesuai yang memungkinkan akses ke alamat IP Accelerator (TCP).
  • Siapa pun yang memiliki akses ke mesin host memiliki akses ke file proyek Anda, terlepas dari struktur izin dalam organisasi Unity Anda. Seperti itu, Unity merekomendasikan membatasi bahwa mesin sehingga hanya Pemilik Organisasi atau Manajer dapat mengakses dan berinteraksi dengan Accelerator.

Persyaratan Editor Unity

Proyek Unity Anda harus menggunakan versi 2019.3 atau lebih tinggi dari Mesin Unity.

Menginstal Accelerator melalui Installer

Jika Anda tidak memiliki Tim Unity Advanced, Anda dapat mengunduh dan menginstal Unity Accelerator langsung dan membatalkan token pendaftaran selama instalasi:

  • Unduh
  • Unduh
  • Unduh

Note: Jika menginstal Accelerator pada sistem Linux, lihat Verifikasi versi Accelerator Anda.

Anda juga dapat menginstal accelerator melalui Docker Hub.

Instalasi Accelerator pada mesin “headless”

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.
  • Gunakan --mode tidak diinginkan untuk instalasi otomatis yang tidak boleh query apa pun. Ini menggunakan nilai default, atau nilai dari bendera opsi lain yang disediakan.
  • Di Mac OS X, Anda perlu memasang gambar disk (DMG) dan menjalankan biner yang terletak di direktori aplikasi installer (dilokasi pada Contents/MacOS/installbuilder.sh).

Mengkonfigurasi Editor untuk menggunakan Accelerator

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:

  1. Di Editor Unity, pilih Edit > Project Settings… (Windows) atau Unity > Project Settings… (OSX).
  2. Pilih Editor dari menu kiri.
  3. Di bawah bagian Cache Server, set Mode ke Enabled.
  4. Isi alamat IP IP address dengan Accelerator dari wizard setup.
  5. Tekan tombol Check Connection untuk menguji konektivitas.
Project settings
Pengaturan proyek

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):

Project connectivity
Konektivitas proyek

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…:

Project connectivity
Konektivitas proyek

Menginstal Accelerator melalui Docker Hub

Sebuah wadah disediakan di Docker Hub di https://hub.docker.com/repository/docker/unitytechnologies/accelerator.

Pengaturan Waktu Pertama

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

Eksekusi Selanjutnya

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.

Menjalankan wadah

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

Port Terkenal

Berikut ini adalah nilai default untuk port yang digunakan oleh Unity Accelerator: 80, 443, 10080, 10443.

Accelerator dengan Tim Unity Lanjutan

Accelerator memberikan manfaat tambahan dengan Advanced:

  • integrasi untuk memastikan aset sumber yang baru ditambahkan atau dimodifikasi dikirimkan di jaringan lokal, secara dramatis mengurangi waktu unduh.
  • Pemantauan Jarak Jauh pada (lihat pemantauan Accelerator).
  • Transportasi aman dan kontrol akses aset sumber dibagi antara Editor Unity dan Accelerator (lihat keamanan aset sumber).
In normal Collaborate workflows, users upload and download from Cloud. With an accelerated Collaborate workflow, uploads are saved to Cloud and the Accelerator, but users download directly from the Accelerator.
Dalam alur kerja Collaborate normal, pengguna mengunggah dan mengunduh dari Cloud. Dengan alur kerja Collaborate yang dipercepat, unggah disimpan ke Cloud dan Accelerator, tetapi pengguna mengunduh langsung dari Accelerator.

Setup

Jika Anda memiliki Tim Unity Advanced, salah satu Pemilik atau Manajer Organisasi Anda dapat membuat Accelerator dari langkah-langkah berikut ini:

  1. Dari tab Develop dasbor, pilih proyek yang ingin Anda buat Accelerator.
  2. Dalam tampilan proyek, pilih Collaborate > Accelerator dari bilah navigasi kiri.
  3. Klik tombol New Accelerator.
  4. Dalam prompt New Accelerator, masukkan agent name untuk Unity untuk digunakan untuk mengidentifikasi agen Accelerator. Anda juga dapat secara opsional menentukan port number.
    New Accelerator window
    Note: Batas arus adalah tiga Accelerator per Organisasi.

    %
  5. Klik Save untuk mengkonfirmasi pengaturan Anda.
  6. Pada layar berikut, salin registration token, lalu klik tombol Download Accelerator di sudut kanan atas, dan pilih sistem operasi yang tepat.

    Download Accelerator from the developer dashboard.
    Docker Hub Anda juga dapat menginstal accelerator melalui .
  7. Luncurkan installer yang diunduh, dan ikuti wizard instalasi. Gunakan registration token yang disalin untuk mendaftarkan Accelerator dengan Unity Collaborate. Ini akan memungkinkan Anda untuk menggunakan Accelerator untuk meningkatkan kinerja Collaborate.

Note: Jika menginstal Accelerator pada sistem Linux, lihat Verifikasi versi Accelerator Anda.

Keamanan aset sumber

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.

Pemantauan Accelerator

WordPress.org

Accelerator memiliki dashboard built-in untuk pemantauan cepat dan perubahan konfigurasi.

Accelerator configuration
Konfigurasi akselerator

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.

WordPress.org (Unity Teams Advanced user only)

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.

Efficiency

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.

Bytes Removed

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.

Bytes Delivered

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.

Time Saved

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).

Accessing Accelerator metrik langsung

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.

1pc/polybag +white box

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

Berhenti dan restart layanan Accelerator

Accelerator berjalan sebagai proses latar belakang untuk setiap platform.

Windows

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.

Mac OS X

Jalankan perintah launchctl dari terminal untuk mengontrol layanan “com.unity.accelerator” dari utilitas LaunchControl. Untuk informasi lebih lanjut, kunjungi url https://www.launchd.info/.

Linux

Gunakan utilitas konsol service untuk mengontrol layanan "as-accelerator". Untuk informasi lebih lanjut, kunjungi http://manpages.ubuntu.com/manpages/bionic/man8/service.8.html.

Maintenance

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.

Alat baris perintah

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.

Mirroring beberapa accelerator

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.

Troubleshooting

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:

Periksa versi Editor Unity dalam penggunaan

Setiap kontributor proyek harus menggunakan versi Editor 2019.3 atau lebih tinggi untuk menggunakan Accelerator.

Verifikasi pengguna berada di jaringan lokal Accelerator

Pastikan Accelerator berjalan di jaringan area lokal yang sama sebagai kontributor proyek mengalami masalah. Accelerator tidak mempengaruhi kontributor yang bekerja jauh.

Uji koneksi Accelerator

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:

  1. Di, pilih Collaborate > Accelerator.
  2. Klik Details untuk Accelerator yang ingin Anda uji.
  3. Klik ikon info di sebelah Alamat IP Accelerator untuk menampilkan URL halaman kesehatannya.

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.

Periksa konfigurasi proyek Accelerator

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.

Verifikasi versi Accelerator Anda

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.

Kunci yang tidak benar

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.

Kunci yang ditempa atau tidak dipercaya

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.

Support

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.

Pindahkan Anda Proyek ke sistem kontrol versi lain
Collaborate pemecahan masalah tips