# Dokumentasi Django 5.2.8

# Bagaimana menyebarkan berkas tetap

Lihat juga

Untuk perkenalan ke penggunaan `django.contrib.staticfiles`, lihat Bagaimana mengelola berkas statik (misalnya gambar, JavaScript, CSS).

## Melayani berkas statis di produksi

Garis besar dasar dari menaruh berkas-berkas tetap kedalam produksi terdiri dari dua langkah: jalankan perintah `collectstatic` ketika berkas tetap berubah, kemudian atur untuk direktori berkas tetap terkumpul (`STATIC_ROOT`) untuk dipindahkan ke peladen berkas tetap dan dilayani. Tergantung pada nama lain `staticfiles` `STORAGES`, berkas mungkin butuh dipindahkan ke tempat baru secara manual atau metode `post_process` dari kelas `Storage` mungkin menangani itu.

Seperti halnya semua tugas penempatan, inti permasalahan ada pada rinciannya. Setiap pengaturan produksi akan sedikit berbeda, jadi anda akan butuh mengadaptasi garis besar dasar untuk menyesuaikan kebutuhan anda. Dibawah ini adalah sedikit corak umum yang mungkin membantu.

### 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 kedalam `STATIC_ROOT`.

- Konfigurasikan peladen jaringan anda untuk melayani berkas-berkas dalam `STATIC_ROOT` dibawah URL `STATIC_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:

- Nginx

- Versi ringkas dari Apache

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.

Terdapat sejumlah jalan anda mungkin lakukan ini, tetapi jika penyedia mempunyai sebuah API, anda dapat menggunakan custom file storage backend untuk menggabungkan CDN dengan proyek Django. Jika anda telah menulis atau menggunakan backend penyimpanan penyesuaian pihak ke3, anda dapat memberitahu `collectstatic` untuk digunakan dengan mengatur `staticfiles` di `STORAGES`.

Sebagai contoh, jika anda telah menulis sebuah backend penyimpanan S3 dalam `myproject.storage.S3Storage` anda dapat menggunakannya dengan:

    STORAGES = {
        # ...
        "staticfiles": {"BACKEND": "myproject.storage.S3Storage"}
    }

Sekali semua dilakukan, semua anda harus lakukan adalah menjalankan `collectstatic` dan berkas-berkas tetap anda akan didorong melalui paket penyimpanan sampai ke S3. Jika anda kemudian membutuhkan mengganti ke penyedia penyimpanan berbeda, anda hanya harus merubah ``staticfiles``di pengaturan `STORAGES`.

Untuk rincian pada bagaimana anda menulis satu dari backend ini, lihat Bagaimana menulis kelas 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.