Automatic Image & Video File(s) Hosting in Cloudinary through Python

About Cloudinary

#

Cloudinary adalah platform penyedia jasa untuk meng-upload, me-manage, dan men-deliver file gambar dan video.¹ Ya, singkatnya, Cloudinary adalah platform untuk hosting file gambar dan video.

Cloudinary vs Google Drive

#

Mungkin ada yang bertanya-tanya,

“Apa bedanya cloudinary dengan Google Drive?”
“Bukankah Google Drive lebih familiar?”

Nah, sebetulnya, secara fungsi dasar, keduanya sama-sama berfungsi untuk menyimpan file gambar dan video (walaupun Google Drive tidak terbatas itu saja) secara daring di cloud, namun, secara fungsi spesifiknya, Google Drive dan Cloudinary memiliki perbedaan yang cukup siginifikan.

Google Drive didesain untuk “backup” file (gambar, video, etc).
Cloudinary didesain untuk “hosting” file (gambar & video).

Satu kata kunci lagi untuk menjelaskan perbedaan keduanya, yaitu CDN (Content Delivery Network) yang bertugas untuk mengurusi masalah performa. Cloudinary dengan tujuannya sebagai tempat hosting, menggunakan CDN, sementara Google Drive tidak.

Artikel ini tidak membahas tentang CDN sehingga jika ingin tahu lebih banyak tentang CDN dapat mengunjungi artikel berikut:
https://www.cloudflare.com/learning/cdn/what-is-a-cdn/

Poin minusnya adalah untuk yang non-bayar (alias gratis), ukuran maksimal file yang dapat di-upload adalah 10 MB untuk file gambar & 100 MB untuk file video.²

Jadi, mana yang lebih baik? Google Drive atau Cloudinary?
Tentu saja, Yang Sesuai Kebutuhan. 😊

Uploading File

#

Sekarang, kita akan mulai mencoba mengunggah file ke Cloudinary. Berikut adalah step by step-nya.

1. Login

#

Kita perlu masuk terlebih dahulu ke Cloudinary terlebih dahulu sebelum dapat menggunakannya. Jika belum memiliki akun, kita harus membuatnya terlebih dahulu. Saya tidak akan membahas secara detail cara membuat & login ke akun di artikel ini karena saya kira cukup mudah untuk dilakukan.

Setelah berhasil login, kira-kira, seperti inilah tampilan interface-nya:

2. Running Python Script

#

Pada tampilan tersebut, klik bagian Python.

Dan kita akan disajikan tahapan-tahapan membuat otomatisasi manajemen file gambar dan video melalui Python di sana, termasuk diantaranya adalah meng-install pip dan bahkan source code Python-nya.

Berikut adalah langkah-langkahnya:

1. Installing python3.

#

Kita perlu meng-install Python3 terlebih dahulu jika belum memilikinya.

Untuk memastikan Python3 sudah terpasang, gunakan perintah:

python --version

2. Creating python venv.

#

Apa itu Virtual Environment

Apa itu virtual environment (venv)?

Sederhananya, virtual environment dalam Python adalah lingkungan khusus (virtual) yang menyediakan paket-paket penting (python interpreter, libraries, dan binaries) yang dapat mendukung pembuatan suatu project (library atau aplikasi). Disebut lingkungan khusus (virtual) karena lingkungan ini (atau kita sebut saja folder / direktori) terisolasi dari software/paket yang ter-install di sistem operasi.

Untuk membuat Python virtual environment untuk Cloudinary kita sekaligus mengaktifkannya, gunakan perintah:

python -m venv cloudinary # membuat virtual environment
source cloudinary/bin/activate # mengaktifkan virtual environment

Keterangan:
Bagian “cloudinary” tersebut adalah nama folder yang akan dibuat oleh Python. Jadi, bagian tersebut dapat diganti dengan preferensi nama yang diinginkan.

3. Installing cloudinary via pip

#

Kita masuk ke dalam direktori “cloudinary” yang tadi sudah berhasil dibuat, kemudian, kita akan meng-install cloudinary melalui binary pip yang terdapat dalam virtual environment tersebut.

cd cloudinary
./bin/pip install cloudinary

4. Creating a script

#

Sekarang, kita akan membuat script Python yang akan mengotomatisasi proses upload filenya.

Berikut adalah script Python yang sudah disediakan oleh Cloudinary:

import cloudinary
import cloudinary.uploader
from cloudinary.utils import cloudinary_url

# Configuration       
cloudinary.config( 
    cloud_name = "<your_cloud_name>", 
    api_key = "<your_api_key>", 
    api_secret = "<your_api_secret>", # Click 'View API Keys' above to copy your API secret
    secure=True
)

# Upload an image
upload_result = cloudinary.uploader.upload("https://res.cloudinary.com/demo/image/upload/getting-started/shoes.jpg",public_id="shoes")
print(upload_result["secure_url"])

# Optimize delivery by resizing and applying auto-format and auto-quality
optimize_url, _ = cloudinary_url("shoes", fetch_format="auto", quality="auto")
print(optimize_url)

# Transform the image: auto-crop to square aspect_ratio
auto_crop_url, _ = cloudinary_url("shoes", width=500, height=500, crop="auto", gravity="auto")
print(auto_crop_url)

Yang perlu kita perhatikan dari kode di atas adalah bagian API credentials-nya, yaitu:

• cloud_name
• api_key
• api_secret

Dan tentu saja:

• upload_result

APIs are mechanisms that enable two software components to communicate with each other using a set of definitions and protocols. For example, the weather bureau’s software system contains daily weather data. The weather app on your phone “talks” to this system via APIs and shows you daily weather updates on your phone.³

Kita perlu mengisi API creds-nya dengan value yang benar. Untuk mengetahuinya, kita hanya perlu mengklik bagian “View API keys” di bagian bawah:

Sebelum menjalankan script-nya, biasanya saya juga meng-comment bagian “Optimize delivery …” dan “Transform the image…” karena tidak memerlukannya.

Sehingga, kurang lebih, final script-nya nanti akan seperti ini:

Running the script

#

Kita coba jalankan…

./bin/python main.py

Berhasil!

Kita juga dapat melihat file yang berhasil terunggah tersebut di akun Cloudinary kita, pada bagian “Media Explorer”: