Istilah Envrc merupakan bentuk penulisan singkat atau kemungkinan besar kesalahan ketik (typo) dari perintah lingkungan kerja seperti .envrc yang umumnya digunakan bersama perangkat lunak pengelola lingkungan direktori seperti direnv. Dalam dunia pengembangan perangkat lunak, file .envrc berfungsi untuk memuat dan membongkar variabel lingkungan secara otomatis saat Anda masuk atau keluar dari suatu direktori tertentu di dalam terminal.
Bagi para pengembang, pengelolaan variabel lingkungan yang spesifik per proyek sangat krusial untuk mencegah kebocoran kunci rahasia (API keys) dan memastikan konfigurasi aplikasi berjalan sesuai dengan tahapan pengembangan lokal. Penggunaan alat bantu seperti direnv yang mengeksekusi file .envrc menjadi standar industri untuk otomatisasi lingkungan kerja berbasis POSIX shell.
Fungsi dan Kegunaan File .envrc
File .envrc bertindak sebagai skrip bash lokal yang dieksekusi oleh utilitas direnv setiap kali direktori kerja terminal Anda berubah. Dengan menempatkan file ini di root direktori proyek, Anda dapat mendefinisikan variabel lingkungan khusus tanpa harus mengekspornya secara manual di terminal utama setiap kali membuka sesi baru.
| Komponen | Keterangan Teknis | Contoh Penggunaan |
|---|---|---|
| Nama File | Diawali dengan titik (.) agar tersembunyi secara default di sistem Unix. | .envrc |
| Alat Pendukung | Membutuhkan utilitas eksternal seperti direnv yang terintegrasi dengan shell (Bash, Zsh, Fish). | eval "$(direnv hook zsh)" |
| Perintah Umum | Digunakan untuk mendefinisikan variabel dan memuat file .env standar. | export DATABASE_URL="postgres://..." atau dotenv |
| Keamanan | Memerlukan izin otorisasi manual (direnv allow) sebelum skrip dieksekusi demi keamanan sistem. |
Mencegah eksekusi skrip berbahaya dari repo asing. |
Cara Penggunaan dan Implementasi Dasar
Untuk mulai menggunakan file .envrc pada proyek Anda, pastikan utilitas direnv telah terpasang di sistem operasi Anda. Berikut adalah langkah-langkah teknis penerapannya di dalam direktori proyek:
# 1. Buat file .envrc di root direktori proyek
echo 'export APP_ENV="development"' > .envrc
echo 'export PORT=8080' >> .envrc
# 2. Berikan izin eksekusi/kepercayaan kepada direnv
direnv allow
# 3. Verifikasi variabel lingkungan aktif
echo $APP_ENV
Ketika Anda keluar dari direktori proyek tersebut, variabel APP_ENV dan PORT akan otomatis dihapus dari memori sesi terminal Anda, menjaga kebersihan lingkungan sistem secara keseluruhan.
Troubleshooting dan Tips Keamanan Lapangan
Dalam praktiknya, kesalahan sering terjadi ketika file .envrc tidak sengaja ikut ter-commit ke sistem kontrol versi seperti Git. Pastikan Anda selalu menambahkan file .envrc ke dalam daftar .gitignore Anda. Selain itu, jika terminal tidak mendeteksi perubahan, pastikan hook shell pada file konfigurasi seperti ~/.zshrc atau ~/.bashrc sudah terpasang dengan benar.