Pengaturan¶

Halaman ini memberi tahu Anda tentang setiap bagian halaman Pengaturan dan tentang file konfigurasi.

Untuk membuka halaman, tekan ⚙ Pengaturan di bilah atas. Halaman ini memiliki bagian berikut, dari atas ke bawah:

Kredensial
Sumber set data
Versi set data dan data lokal (dengan Visualisasi peta di dalamnya)
Memori

Pemilih bahasa tidak ada di halaman Pengaturan. Pemilih bahasa ada di bilah atas. Lihat Bahasa.

Kredensial¶

Bagian Kredensial memiliki satu kartu untuk setiap kredensial:

Judul kartu	Kredensial	Bidang pada kartu
AWS (set data S3)	Satu pasangan kunci AWS. Semua sumber set data S3 menggunakan pasangan kunci yang satu ini.	ID kunci akses, Kunci akses rahasia
Planet	Kunci peta dasar Planet	Nama pengguna, Kunci API
Google Maps	Kunci peta dasar Google Maps	Kunci API
Copernicus (CDSE)	ID instans peta dasar Copernicus (CDSE)	ID instans

Setiap kartu memiliki baris Digunakan dari: yang memberi tahu Anda asal kredensial yang sedang digunakan. Nilai yang mungkin adalah Lingkungan, Rahasia Docker, Pengelola Kredensial, Penyimpanan terenkripsi dan Belum diatur.

Kartu dengan bidang rahasia (Kunci akses rahasia atau Kunci API) juga menunjukkan Tersimpan atau Belum tersimpan. Bidang rahasia selalu kosong, juga setelah Anda menyimpan. Aplikasi tidak pernah mengirim rahasia yang tersimpan kembali ke browser.

Bidang ID kunci akses, Nama pengguna dan ID instans bukan rahasia. Bidang-bidang ini menunjukkan nilai yang ada di penyimpanan terenkripsi.

Tempat mendapatkan setiap nilai¶

AWS (set data S3): Dapatkan ID kunci akses dan kunci akses rahasia untuk akun AWS yang Anda kendalikan. Akun AWS tersebut membayar semua pembacaan set data. Lihat Sumber set data.
Planet: Dapatkan kunci API dan nama pengguna dari akun Planet Anda.
Google Maps: Dapatkan kunci API untuk ubin peta Google Maps dari akun Google Anda.
Copernicus (CDSE): Dapatkan ID instans dari dasbor Copernicus Data Space Anda. ID instans memiliki 8 sampai 64 karakter: hanya huruf, angka, dan tanda hubung.

Menambahkan atau mengubah kunci AWS¶

Di kartu AWS (set data S3), ketik ID kunci di ID kunci akses.
Ketik rahasia di Kunci akses rahasia.
Tekan Periksa kredensial.
Pastikan bahwa baris hasil dimulai dengan "Kunci" dan menyatakan "valid".
Tekan Simpan.

CATATAN: Periksa kredensial tidak dikenai biaya. Pemeriksaan ini hanya menanyakan ke AWS STS apakah pasangan kunci valid. Pemeriksaan ini tidak membaca bucket.

CATATAN: Anda tidak dapat menekan Simpan sampai pasangan kunci lulus Periksa kredensial. Jika Anda mengubah bidang setelah pemeriksaan, Anda harus melakukan pemeriksaan lagi. Aplikasi menunjukkan "Periksa kredensial terlebih dahulu. Pasangan kunci yang gagal diperiksa tidak pernah disimpan."

Untuk memeriksa kunci AWS yang sedang digunakan, biarkan Kunci akses rahasia kosong dan jangan ubah ID kunci akses. Kemudian tekan Periksa kredensial. Jika Anda hanya mengetik salah satu dari kedua nilai, aplikasi menunjukkan "Masukkan ID kunci akses dan kunci akses rahasia sekaligus, atau tidak keduanya."

Hasil Periksa kredensial¶

Hasil	Apa yang diberitahukannya	Apa yang harus dilakukan
"Kunci ... valid: ..."	AWS menerima pasangan kunci. Baris menunjukkan sebagian kunci, identitas AWS, dan 4 digit terakhir akun AWS.	Tekan Simpan jika Anda mengetik pasangan baru.
"AWS menolak kredensial ini ..."	ID kunci atau rahasia salah, atau kunci tidak aktif.	Ketik kedua nilai lagi, lalu tekan Periksa kredensial.
"Tidak ada kredensial AWS yang dimasukkan atau disimpan."	Tidak ada pasangan kunci yang diketik atau disimpan.	Ketik ID kunci dan rahasia.
"Ada kredensial tersimpan, tetapi tidak dapat dibaca ..."	Aplikasi tidak dapat mendekripsi kunci yang tersimpan dengan kunci utama yang aktif.	Ketik ID kunci dan rahasia lagi, lalu simpan.
"AWS STS tidak dapat dijangkau ..."	Masalah jaringan atau titik akhir. Hasil ini tidak memberi tahu Anda tentang kredensial.	Lakukan pemeriksaan lagi.
"AWS STS tidak menjawab tepat waktu."	Pemeriksaan berhenti setelah batas waktu. Hasil ini tidak memberi tahu Anda tentang kredensial.	Lakukan pemeriksaan lagi.
"AWS menjawab ..."	AWS mengirim kode kesalahan yang berbeda. Baris menunjukkan kode tersebut.	Periksa kode tersebut.

Menambahkan atau mengubah kunci peta dasar¶

Di kartu Planet, Google Maps atau Copernicus (CDSE), ketik nilainya. Untuk Planet, ketik Nama pengguna dan Kunci API.
Tekan Uji koneksi.
Pastikan bahwa hasilnya dimulai dengan "Koneksi berhasil."
Tekan Simpan.

CATATAN: Uji koneksi mengirim nilai yang diketik ke penyedia, tetapi tidak menyimpannya. Anda tidak dapat menekan Simpan sampai uji untuk nilai yang sama berhasil. Aplikasi menunjukkan "Uji koneksi terlebih dahulu. Koneksi yang gagal tidak pernah disimpan."

Untuk menguji kunci yang sedang digunakan, biarkan kartu kosong. Kemudian tekan Uji koneksi. Hasilnya adalah salah satu dari berikut:

Sumber yang diuji aplikasi. Contohnya adalah "Kredensial yang sedang dipakai telah diuji (Lingkungan); tidak ada yang diketik di kartu ini."
Jika kartu tidak memiliki nilai yang tersimpan: "Tidak ada yang bisa diuji: kartu ini kosong dan tidak ada yang tersimpan untuknya."

Hasil Uji koneksi untuk peta dasar¶

Uji yang berhasil dimulai dengan "Koneksi berhasil." Uji yang gagal dimulai dengan "Koneksi gagal:". Alasannya menyusul.

Hasil	Apa yang diberitahukannya
berhasil: "Penyedia menerima kredensial ini."	Kunci benar.
ditolak: "Penyedia menolak kredensial ini. ..."	Nilai salah, atau nilai tersebut tidak memiliki izin sekarang.
tidak terjangkau: "Penyedia tidak dapat dijangkau ..."	Masalah jaringan atau titik akhir. Hasil ini tidak memberi tahu Anda tentang kredensial.
habis waktu: "Penyedia tidak merespons dalam waktu yang diizinkan. ..."	Penyedia terlalu lambat, atau aplikasi tidak dapat menjangkaunya. Hasil ini tidak memberi tahu Anda tentang kredensial.
salah konfigurasi: "Penyedia salah dikonfigurasi di server, ..."	Konfigurasi server untuk penyedia ini memiliki masalah. Aplikasi tidak menguji kredensial.
belum dikonfigurasi: "Tidak ada kredensial yang tersedia untuk diuji."	Tidak ada kredensial yang ditemukan.

Tempat aplikasi menyimpan kredensial¶

Aplikasi mencari setiap kredensial di 4 tempat, dengan urutan ini. Aplikasi menggunakan yang pertama ditemukannya:

Lingkungan: variabel lingkungan. Namanya adalah AWS_ACCESS_KEY_ID dan AWS_SECRET_ACCESS_KEY (dan AWS_SESSION_TOKEN yang opsional), PLANET_API_KEY (sebagai user:key), GOOGLE_MAPS_API_KEY dan CDSE_INSTANCE_ID.
Rahasia Docker: file dengan nama yang sama di folder Docker secrets. Folder bawaannya adalah /run/secrets.
Pengelola Kredensial: Windows Credential Manager. Kunci konfigurasi security.credential_manager_names dan security.credential_manager_pairs memberikan nama targetnya.
Penyimpanan terenkripsi: kredensial yang Anda simpan di halaman Pengaturan.

Penyimpanan terenkripsi menyimpan satu file untuk setiap kredensial (<name>.enc.json) di folder yang diberikan security.secret_store_dir. Bawaannya adalah ./data/secrets.d, relatif terhadap folder file konfigurasi. Di image Docker, folder ini adalah /data/data/secrets.d.

Sebuah kunci utama mengenkripsi penyimpanan. Untuk melihat asal kunci utama, buka Detail di bagian Kredensial. Jika kunci utama adalah file di pohon folder yang sama dengan kredensial yang tersimpan, aplikasi menunjukkan pesan peringatan. Siapa pun yang dapat membaca folder tersebut kemudian dapat mendekripsi kredensial.

PERINGATAN: Jika kunci utama adalah file di samping data, berikan kunci melalui LUC_ANALYTICS_SECRET_KEY (variabel lingkungan atau Docker secret). Orang yang dapat membaca file kunci dapat membaca kredensial Anda yang tersimpan.

Menghapus kredensial yang tersimpan¶

CATATAN: Prosedur ini hanya menghapus kredensial dari penyimpanan terenkripsi. Prosedur ini tidak menghapus variabel lingkungan, Docker secret, atau nilai di Windows Credential Manager. Anda harus menghapusnya di sumbernya.

Di bagian Kredensial, buka Detail.
Temukan baris kredensial. Kolom Penyimpanan terenkripsi menunjukkan Tersimpan, atau Tersimpan, tidak digunakan (sumber di atas lebih diutamakan).
Tekan Hapus yang tersimpan.
Baca pesan, lalu tekan OK.
Pastikan bahwa aplikasi menunjukkan "Kredensial tersimpan dihapus."

PERHATIAN: Anda tidak dapat membatalkan penghapusan. Untuk menggunakan kredensial lagi, ketik dan simpan lagi.

Sumber set data¶

Bagian Sumber set data memberi tahu aplikasi tempat membaca setiap dari 6 set data: Luas piksel, Hutan alam SBTN, Tutupan hutan global JRC 2020, Peringatan gangguan, Pemicu kehilangan tutupan pohon dan Tahun kehilangan tutupan pohon.

Privasi dan biaya membaca bucket WRI¶

Bagian ini dimulai dengan pemberitahuan Privasi dan biaya membaca bucket WRI. Pemberitahuan ini memberi tahu Anda fakta berikut:

WRI adalah sumber set data. Pemberitahuan memiliki tautan ke halaman WRI Data Explorer.
Saat aplikasi membaca set data dari bucket S3 WRI, WRI mencatat permintaan di log penyimpanannya. Log menunjukkan bagian-bagian set data yang diminta aplikasi. Dengan demikian, log dapat menunjukkan area yang Anda analisis. Aplikasi tidak pernah mengirim bentuk lokasi Anda.
Bucket WRI menggunakan skema Peminta membayar (Requester Pays di AWS). Setiap permintaan dan setiap byte yang ditransfer aplikasi dibebankan ke akun AWS Anda. Ini termasuk setiap unduhan.

PERINGATAN: Semua pembacaan data dari bucket WRI menimbulkan tagihan ke akun AWS Anda. Aplikasi memberikan biaya sekitar $0.09 untuk setiap GB ke komputer di luar AWS, ditambah biaya kecil untuk setiap pembacaan. Ini adalah daftar harga AWS dan dapat berubah.

Untuk mencegah pembacaan ini, unduh salinan setiap set data ke komputer ini. Setelah unduhan, analisis tidak membaca apa pun dari WRI.

Kartu set data¶

Setiap set data memiliki kartu. Kartu menunjukkan baris Dipakai:, kata status, dan tombol Ubah. Baris Dipakai: memberi tahu Anda apa yang dibaca set data sekarang, misalnya "Dipakai: WRI daring, terbaru — ditagih per analisis". Kata status adalah Terbaru, Ada versi yang lebih baru, Belum diperiksa atau Mengunduh….

Tekan Lihat versi untuk pergi ke versi set data tersebut di Versi set data dan data lokal.

Mengubah sumber set data¶

Saat Anda menekan Ubah, dialog terbuka. Langkah pertama menanyakan "Dari mana set data harus diambil?". Anda dapat memilih salah satu dari 3 pilihan:

Pilihan	Apa yang dilakukannya
WRI daring, selalu yang terbaru	Setiap analisis membaca set data dari bucket WRI. Setiap analisis menimbulkan tagihan ke akun AWS Anda.
Unduh salinan ke komputer ini	Aplikasi mengunduh satu salinan. Anda membayar satu kali untuk transfer. Kemudian analisis membaca salinan tanpa biaya.
Folder yang sudah saya miliki (lanjutan)	Aplikasi membaca folder zarr yang sudah ada di komputer ini. Aplikasi tidak pernah menulis ke folder tersebut.

Aplikasi menunjukkan Disarankan di samping pilihan yang sesuai dengan seberapa sering set data berubah. Aplikasi tidak mengubah sumber dengan sendirinya.

Jika tidak ada kunci AWS yang lulus pemeriksaan, dialog menambahkan langkah Tambahkan kunci AWS Anda. Ketik ID kunci akses dan Kunci akses rahasia, lalu tekan Periksa kunci ini. Anda tidak dapat menekan Berikutnya sampai kunci lulus pemeriksaan.

Tidak ada yang berubah sampai Anda menekan tombol terakhir dialog. Untuk berhenti, tekan Batal, tekan ×, atau tekan tombol Esc.

Mengunduh salinan ke komputer ini¶

PERINGATAN: Unduhan menimbulkan tagihan ke akun AWS Anda untuk transfer data. Pastikan bahwa Anda menerima biayanya sebelum Anda menekan Mulai unduhan.

Di kartu set data, tekan Ubah.
Pilih Unduh salinan ke komputer ini.
Tekan Berikutnya.
Jika dialog menanyakan "Versi set data yang mana?", pilih Terbaru (perlu diunduh) atau salinan yang sudah ada di komputer ini.
Tekan Berikutnya.
Jika dialog meminta kunci AWS, ketik kunci dan tekan Periksa kunci ini. Kemudian tekan Berikutnya.
Di Tujuan, ketik folder atau tekan Telusuri… untuk memilih folder. Lihat Penelusur folder.
Pastikan bahwa dialog tidak menunjukkan "Ruang kosong tidak cukup untuk set data ini."
Tekan Berikutnya.
Pilih kotak Saya memahami bahwa unduhan ini ditagihkan ke akun AWS saya.
Tekan Mulai unduhan.

Jika Anda memilih salinan yang sudah ada di komputer ini, dialog menanyakan "Gunakan salinan dari date?". Tekan Gunakan salinan ini. Tindakan ini tidak membuat permintaan dan tidak dikenai biaya.

Sampai unduhan selesai, analisis terus membaca set data dari WRI daring. Saat unduhan selesai, set data membaca salinan lokal.

Selama unduhan berlangsung, kartu menunjukkan Jeda, Lanjutkan dan Hentikan. Jeda menyimpan file yang sudah diterima. Hentikan menanyakan Anda terlebih dahulu. Jika Anda menekan Hentikan dan buang, aplikasi menghapus salinan sebagian, dan unduhan berikutnya dimulai lagi tanpa file. Tekan Lanjutkan unduhan untuk melanjutkan.

Penelusur folder¶

Bidang Tujuan dan Jalur folder memiliki kotak teks dan tombol Telusuri…. Anda dapat mengetik jalur folder lengkap di kotak teks.

Tekan Telusuri…. Penelusur menunjukkan Akar unduhan yang disetujui.
Pilih folder untuk membukanya.
Untuk naik satu tingkat, tekan Naik.
Saat penelusur menunjukkan folder yang benar, tekan Gunakan folder ini.
Untuk menutup penelusur tanpa perubahan, tekan Tutup penelusur.

Penelusur hanya menunjukkan folder. Penelusur tidak pernah menunjukkan file atau folder di luar akar yang disetujui.

Unduhan hanya masuk ke folder di datasets.download_roots di file konfigurasi. Di image Docker, akar unduhan bawaannya adalah /data/datasets. Jika tidak ada akar unduhan yang dikonfigurasi, penelusur menunjukkan "Tidak ada akar unduhan yang dikonfigurasi di server ini (datasets.download_roots), sehingga tidak ada yang bisa ditelusuri atau diunduh."

Untuk Folder yang sudah saya miliki (lanjutan), penelusur juga menunjukkan folder di datasets.browse_roots dengan label "(hanya baca)". Anda juga dapat mengetik folder di luar akar. Kemudian aplikasi membaca folder tersebut tetapi tidak pernah menulis ke dalamnya.

Pada server di WSL, aplikasi membaca jalur Windows seperti D:\data sebagai /mnt/d/data. Jika drive tersebut tidak dipasang, aplikasi menunjukkan "Drive itu tidak tersedia di server ini (tidak dipasang)."

Kepala bagian Sumber set data¶

Periksa pembaruan $ membaca manifes WRI dan memberi tahu Anda berapa banyak set data yang memiliki versi yang lebih baru. Ini adalah satu permintaan ke bucket WRI. Jadi, ini menimbulkan tagihan kecil ke akun AWS Anda.
Perbarui semua ke terbaru mengunduh versi yang lebih baru dari setiap set data yang membaca salinan lokal. Sebelum unduhan dimulai, Anda harus memilih kotak Saya memahami bahwa unduhan ini ditagihkan ke akun AWS saya.
Simpan pengaturan ini menyimpan pilihan set data saat ini. Kembali ke pengaturan ini mengembalikan pengaturan yang tersimpan.

Lanjutan¶

Panel Lanjutan di bagian bawah bagian ini adalah untuk pilihan yang tidak dapat dibuat dialog. Untuk setiap set data, panel ini menunjukkan Jenis sumber, Lokasi, Peminta membayar, Gunakan jalur manifes $, Uji koneksi dan Simpan sumber.

PERHATIAN: Gunakan panel Lanjutan hanya jika Anda mengetahui lokasi S3 set data. Lokasi yang salah memberikan hasil yang salah atau tidak memberikan hasil.

Peminta membayar harus menyala untuk bucket WRI. Jika mati, aplikasi tidak membuat permintaan yang ditagih.

Uji koneksi di panel Lanjutan membuka penyimpanan set data. Ini menimbulkan tagihan ke akun AWS Anda. Hasil yang berhasil dimulai dengan "Koneksi berhasil." Hasil yang gagal dimulai dengan "Koneksi gagal:". Alasannya adalah sebagai berikut:

Hasil	Apa yang diberitahukannya
"Koneksi berhasil. ..."	Set data terbuka dan aplikasi dapat membacanya.
Peminta membayar mati	Kredensial benar, tetapi Peminta membayar mati. Nyalakan Peminta membayar.
AWS menolak kredensial	Kunci dicabut, salah, atau tidak memiliki izin.
Tidak ada kredensial AWS	Tidak ada kunci AWS yang tersedia. Tambahkan kunci, lalu simpan dan uji lagi.
Kredensial tersimpan tidak dapat dibaca	Aplikasi tidak dapat mendekripsi kunci yang tersimpan. Ketik kunci lagi dan simpan.
Tidak dapat dijangkau	Masalah jaringan atau titik akhir. Ini bukan masalah kredensial.
Bukan penyimpanan Zarr	Lokasi benar, tetapi tidak memiliki penyimpanan Zarr yang dapat dibaca.
Waktu habis	Set data tidak menjawab dalam batas waktu.
Lokasi tidak ditemukan	Tidak ada apa pun di lokasi tersebut. Tekan Gunakan jalur manifes $.
Region tidak cocok	Bucket ada di region yang berbeda. Ubah `datasets.upstream.region` di `config.yaml`.
AccessDenied	Kunci valid tetapi tidak dapat membaca bucket ini. Tekan Periksa kredensial.
Kesalahan AWS lainnya	AWS mengirim kode kesalahan yang berbeda. Baris menunjukkan kode tersebut.

Versi set data dan data lokal¶

Bagian ini menunjukkan setiap versi bertanggal dari setiap set data, tempat aplikasi menyimpannya, dan berapa banyak ruang disk yang digunakannya.

Aplikasi menyimpan 3 jenis salinan:

Disimpan otomatis: aplikasi membuat salinan ini saat Anda menjalankan daftar. Salinan ini dihitung terhadap Batas ruang.
Unduhan penuh: salinan yang Anda unduh di Sumber set data. Aplikasi tidak pernah menghapusnya.
Salinan Anda sendiri: salinan di folder yang Anda pilih. Aplikasi tidak pernah menghapusnya.

Untuk mengubah batas ruang, ketik nilai dari 1 sampai 10000 di Batas untuk cache otomatis (GB), lalu tekan Simpan batas. Bawaannya adalah 50 GB.

PERINGATAN: Jika batas baru kurang dari ruang yang sedang digunakan, aplikasi langsung menghapus lapisan tersimpan yang lebih lama. Jika proses berikutnya memerlukan lapisan yang sudah dihapus, aplikasi mengunduhnya lagi, dan itu menimbulkan tagihan ke akun AWS Anda.

Untuk menghapus salinan, pilih salinan di Versi per set data, lalu tekan Hapus yang dipilih. Baca daftar di dialog, lalu tekan Hapus.

Visualisasi peta menunjukkan ruang disk yang digunakan data peta yang tersimpan. Ketik nilai di Batas (GB), lalu tekan Simpan batas. Aplikasi menyimpan peta sampai Anda menghapusnya. Untuk menghapus data peta, gunakan Hapus untuk daftar terpilih… atau Hapus total semua data peta….

Memori¶

Bagian Memori mengatur berapa banyak memori yang dapat digunakan aplikasi. Bagian ini memiliki 4 bagian:

1. Lingkungan: Batas memori host / VM (GB). Aplikasi menemukan nilai ini saat berjalan di kontainer. Untuk mengatur nilai yang lebih rendah, tekan Timpa. Untuk kembali, tekan Gunakan yang terdeteksi.
2. Aplikasi ini: Dicadangkan untuk sistem operasi (GB) dan Memori yang dialokasikan ke aplikasi (GB). Cadangan bawaan adalah nilai yang lebih besar dari 3 GB dan 10% dari batas host. Aplikasi juga menunjukkan nilai minimum yang disarankan. Sampai aplikasi mengukur suatu nilai, minimumnya adalah 2.0 GB.
3. Cara alokasi dibagi: tabel pembagian. Anda tidak dapat mengubah pembagian di halaman ini. Pembagian diatur di config.yaml (analysis.memory_shares) dan berlaku setelah mulai ulang.
4. Detail render: Maks sel pada asli. Ini adalah jumlah maksimum sel yang dapat dikembalikan satu tampilan pada resolusi asli.

Untuk mengubah nilai memori:

Ketik nilai baru.
Pastikan bahwa bagian ini tidak menunjukkan kesalahan.
Tekan Terapkan.

Nilai langsung berlaku. Anda tidak perlu memulai ulang aplikasi.

PERHATIAN: Jika Memori yang dialokasikan ke aplikasi (GB) kurang dari minimum yang disarankan, analisis dapat gagal. Aplikasi menunjukkan pesan peringatan, tetapi mengizinkan Anda menerapkan nilai tersebut.

Bahasa¶

Pemilih bahasa ada di bilah atas, di sebelah kanan ⚙ Pengaturan. Pemilih ini memiliki bahasa berikut: English (en), Español (es), Français (fr), Bahasa Indonesia (id) dan Português (pt).

Tekan pemilih bahasa.
Pilih bahasa.

Aplikasi langsung mengubah bahasa. Browser menyimpan pilihan Anda untuk kunjungan berikutnya.

CATATAN: Panduan pengguna ini juga tersedia dalam bahasa lain di aplikasi: English, Español, Français dan Português. Gunakan panduan dalam bahasa yang Anda pilih, sehingga label di panduan sama dengan label di layar Anda.

File konfigurasi¶

File konfigurasi berisi pengaturan yang tidak dapat diubah halaman Pengaturan. Di image Docker, file tersebut adalah /data/config.yaml. Variabel lingkungan LUC_ANALYTICS_CONFIG dapat memberikan jalur yang berbeda.

Saat kontainer dimulai untuk pertama kali, kontainer membuat /data/config.yaml dari config.example.yaml. Kontainer menyalakan unggahan dan mengatur akar unduhan ke /data/datasets. File tersebut juga menyalakan penyedia Copernicus. Lihat Peta dasar Sentinel-2. Kontainer tidak pernah mengubah file konfigurasi yang sudah ada.

config.example.yaml mencantumkan setiap kunci dengan nilai bawaannya. Di image Docker, /data/config.yaml adalah salinan lengkap file tersebut, dan aplikasi hanya membaca /data/config.yaml. Jika Anda menghapus kunci darinya, aplikasi menggunakan nilai bawaan di kode program. Nilai ini dapat berbeda dari nilai di config.example.yaml. Misalnya, bawaan program untuk maps.cdse_enabled adalah false.

CATATAN: Jika Anda memulai aplikasi tanpa Docker, dengan file yang bernama config.yaml, aplikasi membaca config.example.yaml terlebih dahulu. Kemudian nilai di config.yaml menggantikan nilai di config.example.yaml. Kami menyarankan agar config.yaml ini hanya berisi kunci yang Anda ubah.

Kunci-kunci berikut berhubungan dengan halaman Pengaturan:

Kunci	Apa yang dikendalikannya
`datasets.download_roots`	Folder yang dapat dimasuki unduhan. Daftar kosong menghentikan semua unduhan.
`datasets.browse_roots`	Folder tambahan yang ditunjukkan penelusur folder. Aplikasi hanya membaca folder ini.
`datasets.upstream.region`, `datasets.upstream.regions`	Region AWS sumber S3. Bucket WRI ada di `us-east-1`.
`datasets.upstream.cadence`	Seberapa sering setiap set data berubah. Ini mengatur pilihan Disarankan.
`datasets.cost_model`	Harga yang digunakan aplikasi untuk menghitung biaya pembacaan S3.
`datasets.zarr_store.max_gb`	Batas untuk cache otomatis (live; bawaan 50).
`viz.grid_store_max_gb`	Batas untuk visualisasi peta (live; bawaan 2.0).
`analysis.memory_budget_gb`	Memori yang dialokasikan ke aplikasi (live; bawaan 1.5).
`analysis.memory_shares`	Pembagian alokasi memori.
`analysis.zoom_adaptive.max_cells_ceiling`	Maks sel pada asli (live; bawaan 200000).
`security.*`	Kunci utama, folder penyimpanan rahasia, folder Docker secrets, dan nama Credential Manager.
`maps.*`	Penyedia peta dasar, misalnya `maps.cdse_enabled`.
`ingest.upload_enabled`	Unggahan menyala atau mati.

Kunci dengan kata "live" di tabel juga dapat berubah di halaman Pengaturan. Halaman menyimpan nilai di file overlay runtime (runtime.overlay_path, bawaan ./data/runtime-overlay.yaml). Di image Docker, file ini adalah /data/data/runtime-overlay.yaml. Nilai di overlay runtime memiliki prioritas di atas kunci yang sama di config.yaml. Semua kunci lain hanya berlaku setelah mulai ulang.

Mengubah file konfigurasi di Docker¶

File /data/config.yaml ada di volume Docker, bukan di komputer Anda. Untuk mengubahnya, salin file keluar dari kontainer, ubah salinannya, dan salin kembali ke dalam. Langkah-langkah ini menggunakan nama kontainer luc-analytics dari Memasang dan memulai aplikasi.

PERINGATAN: Jangan tulis kredensial di config.yaml. Aplikasi tidak membaca kredensial dari file konfigurasi. Gunakan bagian Kredensial, variabel lingkungan, Docker secrets, atau Windows Credential Manager.

PERHATIAN: Jangan ubah file overlay runtime secara manual. Jika file tersebut berisi kunci yang tidak diizinkan, aplikasi mengabaikan seluruh file.

Buka terminal di sebuah folder di komputer Anda.
Salin file keluar dari kontainer:

docker cp luc-analytics:/data/config.yaml config.yaml

Buat salinan kedua config.yaml dengan nama config.yaml.bak. Simpan salinan ini untuk dikembalikan jika perubahan gagal.
Buka config.yaml di editor teks.
Temukan kunci di config.example.yaml dan salin namanya dengan tepat. Untuk membaca config.example.yaml, ketik docker exec luc-analytics cat /app/config.example.yaml.
Ubah nilainya. Pertahankan indentasi struktur YAML.
Simpan file.
Salin file kembali ke dalam kontainer:

docker cp config.yaml luc-analytics:/data/config.yaml

Mulai ulang kontainer:

docker restart luc-analytics

Ketik docker logs luc-analytics dan baca log. Jika nama kunci salah, log menunjukkan pesan peringatan dengan nama kunci lengkap.

CATATAN: docker cp menjadikan pengguna root sebagai pemilik file yang disalin. Aplikasi berjalan sebagai pengguna 10001, dan aplikasi hanya membaca /data/config.yaml. Dengan demikian, Anda tidak perlu mengubah pemilik file.

PERHATIAN: Kunci yang tidak dikenal di bawah security menghentikan pemuatan konfigurasi. Jika aplikasi tidak mulai setelah perubahan, salin config.yaml.bak kembali ke dalam kontainer dengan docker cp, lalu mulai ulang kontainer.