menyebarkan berkas tetap¶
lihat juga
Untuk perkenalan ke penggunaan django.contrib.staticfiles
, lihat Mengelola berkas statis (sebagai contoh gambar, JavaScript, CSS).
Melayani berkas statis di produksi¶
The basic outline of putting static files into production consists of two
steps: run the collectstatic
command when static files change, then
arrange for the collected static files directory (STATIC_ROOT
) to be
moved to the static file server and served. Depending on
STATICFILES_STORAGE
, files may need to be moved to a new location
manually or the post_process
method of
the Storage
class might take care of that.
As with all deployment tasks, the devil's in the details. Every production setup will be a bit different, so you'll need to adapt the basic outline to fit your needs. Below are a few common patterns that might help.
Melayani situs dan berkas-berkas tetap anda dari peladen sama¶
Jika anda ingin melayani berkas-berkas tetap anda dari peladen sama yang sudah melayani situs anda, pengolahan mungkin terlihat sesuatu seperti:
- Dorong kode anda ke atas ke peladen penyebaran.
- Di peladen, jalankan
collectstatic
untuk menyalin semua berkas statis kedalamSTATIC_ROOT
. - Konfigurasikan peladen jaringan anda untuk melayani berkas-berkas dalam
STATIC_ROOT
dibawah URLSTATIC_URL
. Sebagai contoh, ini how to do this with Apache and mod_wsgi.
Anda mungkin akan ingin mengotomatisasi pengolahan ini, khususnya jika anda mendapatkan banyak peladen jaringan.
Melayani berkas statis dari sebuah server tersendiri¶
Kebanyakan situs Django besar menggunakan peladen Jaringan terpisah -- yaitu, satu yang tidak juga menjalankan Django -- untuk melayani berkas-berkas tetap. Peladen ini sering berjalan jenis berbeda dari peladen jaringan -- lebih cepat tetapi sedikit fitur-penuh. Beberapa pilihan umum adalah:
Konfigurasi peladen ini diluar cakupan dari dokumen ini; periksa setiap dokumentasi masing-masing peladen untuk perintah.
Sejak peladen berkas tetap anda tidak akan menjalankan Django, anda akan butuh merubah strategi penyebaran menjadi kelihatan sesuatu seperti:
- Ketika berkas statis anda berubah, jalankan
collectstatic
secara lokal. - Dorong
STATIC_ROOT
lokal anda sampai pada peladen berkas tetap kedalam direktori yang sedang dilayani. rsync adalah sebuah pilihan umum untuk langkah ini sejak dia hanya butuh memindahkan bit ke berkas-berkas tetap yang telah berubah.
Melayani berkas statis dari layanan cloud atau CDN¶
Taktik umum lainnya adalah melayani berkas tetap dari penyedia penyimpanan awan seperti S3 Amazon dan/atau CDN (content delivery network). Ini membuat anda mengabaikan masalah dari melayani berkas tetap dan dapat sering membuat untuk memuat-lebih cepat halaman Jaringan (khususnya ketika menggunakan CDN).
Ketika menggunakan layanan ini, alurkerja dasar akan kelihatan sedikit seperti diatas, kecuali bahwa daripada menggunakan rsync
untuk memindahkan berkas-berkas tetap anda ke peladen anda akan butuh untuk memindahkan berkas-berkas tetap ke penyedia panyimpanan atau CDN.
There's any number of ways you might do this, but if the provider has an API,
you can use a custom file storage backend
to integrate the CDN with your Django project. If you've written or are using a
3rd party custom storage backend, you can tell collectstatic
to use
it by setting STATICFILES_STORAGE
to the storage engine.
Sebagai contoh, jika anda telah menulis sebuah backend penyimpanan S3 dalam myproject.storage.S3Storage
anda dapat menggunakannya dengan:
STATICFILES_STORAGE = 'myproject.storage.S3Storage'
Once that's done, all you have to do is run collectstatic
and your
static files would be pushed through your storage package up to S3. If you
later needed to switch to a different storage provider, you may only have to
change your STATICFILES_STORAGE
setting.
Untuk rincian pada bagaimana anda menulis satu dari backend ini, lihat Menulis sistem penyimpanan disesuaikan. Ada aplikasi pihak 3 tersedia yang menyediakan backend penyimpanan untuk banyak API penyimpanan berkas umum. Titik awal bagus adalah overview at djangopackages.org.
Pelajari lagi¶
Untuk rincian lengkap pada semua pengaturan, perintah, cetakan etiket, dan potongan-potongan lainnya dalam django.contrib.staticfiles
, lihat the staticfiles reference.