All Products
Search
Document Center

Function Compute:Praktik terbaik untuk mengakses Redis

Last Updated:Jun 22, 2026

Di Function Compute, status tidak dibagikan antar instans lingkungan eksekusi yang berbeda. Anda dapat menggunakan database untuk menyimpan data terstruktur secara persisten guna mencapai berbagi status. Dengan mengakses database cloud melalui Function Compute, Anda dapat melakukan operasi seperti kueri dan penyisipan data. Topik ini menggunakan Python 3 sebagai contoh untuk menjelaskan cara mengakses Tair (Redis OSS-compatible) dalam VPC yang sama atau lintas VPC dan wilayah.

Prasyarat

Buat instans Redis

Prosedur

Langkah 1: Konfigurasikan daftar putih database

Skenario 1: Akses database Redis dalam VPC yang sama

Penting
  • Pastikan instans database yang Anda buat berada di wilayah yang sama dengan fungsi yang perlu mengaksesnya.

  • Instans database harus dibuat di zona yang didukung oleh Function Compute. Untuk informasi selengkapnya, lihat Zona yang didukung oleh Function Compute.

  • Jika instans database Anda tidak ditempatkan di zona yang didukung oleh Function Compute, buat vSwitch di VPC Anda yang berada di zona yang sama dengan Function Compute. Selanjutnya, tentukan ID vSwitch tersebut dalam konfigurasi VPC layanan tertentu di Function Compute. Karena jaringan pribadi dapat saling berkomunikasi antar vSwitch berbeda dalam VPC yang sama, Function Compute dapat mengakses resource di zona lain melalui vSwitch tersebut. Untuk informasi selengkapnya, lihat Apa yang harus saya lakukan jika muncul error vSwitch berada di zona yang tidak didukung?.

  1. Masuk ke Konsol Tair (Redis OSS-compatible). Di bilah navigasi atas, pilih wilayah, lalu klik ID instans target dan lihat detail VPC instans Redis di halaman Informasi Instans.

  2. Masuk ke Konsol Function Compute dan buat fungsi web Python. Di halaman detail fungsi, pilih tab Configuration. Temukan Advanced Settings dan klik Modify. Di panel Advanced Settings, pada bagian Network, aktifkan akses VPC untuk fungsi tersebut, lalu konfigurasikan resource VPC target.

    Catatan

    Pastikan VPC yang dikonfigurasi untuk fungsi tersebut sama dengan VPC tempat instans database terhubung.

    Bagian konfigurasi jaringan memiliki tiga bidang wajib: VPC, vSwitch, dan Security group. Pilih resource yang sesuai untuk setiap bidang dari daftar drop-down. Kami merekomendasikan agar Anda mengonfigurasi vSwitch di dua zona atau lebih untuk memanfaatkan sepenuhnya kemampuan disaster recovery multi-zona Function Compute.

  3. Di halaman detail fungsi, pilih tab Configuration. Di bagian Network, peroleh Blok CIDR vSwitch yang dikonfigurasi untuk fungsi tersebut.

  4. Tambahkan Blok CIDR vSwitch dari konfigurasi fungsi yang diperoleh pada langkah sebelumnya ke daftar putih akses database.

    Penting

    Gunakan daftar putih alamat IP untuk memberi otorisasi fungsi mengakses database. Jangan gunakan mode security group. Jika tidak, fungsi mungkin sesekali gagal terhubung ke database, yang berdampak pada bisnis.

    1. Masuk ke Konsol, pilih wilayah di bilah navigasi atas, lalu klik ID instans target.

    2. Di halaman detail instans, di panel navigasi kiri, pilih Whitelist settings. Di tab Whitelist settings, temukan kelompok daftar putih target dan klik Modify di kolom Actions.

    3. Di panel Modify whitelist group yang muncul, masukkan Blok CIDR vSwitch ke dalam bidang IP addresses in whitelist group. Lalu, klik OK.

      Untuk Add method, pilih Manual add. Anda dapat memasukkan satu alamat IP (misalnya, 192.168.1.1) atau Blok CIDR (misalnya, 192.168.1.0/24). Pisahkan beberapa entri dengan koma.

Setelah konfigurasi selesai, fungsi dapat mengakses database Redis melalui titik akhir internal database tersebut.

Skenario 2: Akses database Redis lintas VPC atau wilayah

VPC dan wilayah yang berbeda sepenuhnya terisolasi secara logis satu sama lain. Secara umum, Anda tidak dapat mengakses database lintas VPC atau wilayah. Jika Anda perlu mengakses database lintas VPC atau wilayah, Anda dapat mengonfigurasi Alamat IP publik statis untuk fungsi tersebut. Dalam kasus ini, sistem akan membuat Gateway NAT publik di virtual private cloud (VPC) tempat fungsi tersebut terhubung. Anda dapat mengakses database melalui alamat IP publik menggunakan gerbang publik.

  1. Masuk ke Konsol Tair (Redis OSS-compatible). Klik ID instans target dan buka halaman Informasi Instans untuk melihat detail VPC instans Redis.

  2. Masuk ke Konsol Function Compute dan buat fungsi web Python. Di halaman detail fungsi, pilih tab Configuration. Temukan Advanced Settings dan klik Modify. Di panel Advanced Settings, temukan bagian Network. Aktifkan opsi Static Public IP Address dan nonaktifkan opsi Allow Default NIC to Access Internet untuk memastikan Alamat IP publik statis berlaku. Lalu, klik Deploy.

    Catatan

    Mengatur Allow Default NIC to Access Internet ke No akan mengaktifkan Alamat IP publik statis. Function Compute menonaktifkan antarmuka jaringan default, sehingga memaksa trafik mengakses internet melalui antarmuka jaringan yang terikat ke VPC.

  3. Di halaman detail fungsi, pilih tab Configuration. Di bagian Network, peroleh alamat IP elastis yang dikonfigurasi untuk fungsi tersebut.

  4. Tambahkan Alamat IP publik statis fungsi yang diperoleh pada langkah sebelumnya ke daftar putih akses database.

    Penting

    Gunakan daftar putih alamat IP untuk memberi otorisasi fungsi mengakses database. Jangan gunakan mode security group. Jika tidak, fungsi mungkin sesekali gagal terhubung ke database, yang berdampak pada bisnis.

    1. Masuk ke Management Console, pilih wilayah di bagian atas, lalu klik ID instans target.

    2. Di panel navigasi kiri, pilih Whitelist settings. Di tab Whitelist settings, temukan kelompok daftar putih target dan klik Modify di kolom Actions.

    3. Di panel Modify whitelist group, masukkan Alamat IP publik statis ke dalam bidang IP addresses in whitelist group. Lalu, klik OK.

      Panel tersebut mencatat bahwa 0.0.0.0/0 mengizinkan akses dari alamat mana pun. Anda dapat memasukkan alamat IP individual atau Blok CIDR, dipisahkan dengan koma. Untuk Add method, pilih Manual add.

Setelah konfigurasi selesai, fungsi dapat mengakses database Redis melalui titik akhir publik database tersebut.

Langkah 2: Akses Redis dalam fungsi

  1. Masuk ke Konsol Function Compute. Temukan fungsi target dalam daftar fungsi. Di halaman detail fungsi, klik tab Code dan masukkan kode contoh berikut di editor kode.

    from flask import Flask,jsonify
    import os
    import redis
    app = Flask(__name__)
    # Variabel global untuk menyimpan koneksi Redis singleton.
    _redis_connection = None
    # Buat koneksi database (pola singleton).
    def getConnection():
        global _redis_connection
        try:
            # Jika koneksi sudah ada dan aktif, kembalikan koneksi tersebut.
            if _redis_connection is not None:
                try:
                    # Uji apakah koneksi valid dengan perintah ping sederhana.
                    if _redis_connection.ping():
                        return _redis_connection
                except redis.ConnectionError:
                    # Jika koneksi rusak, atur ulang.
                    _redis_connection = None
            # Jika koneksi tidak ada atau rusak, buat koneksi baru.
            _redis_connection = redis.Redis(
                host=os.environ['REDIS_HOST'],
                password=os.environ['REDIS_PASSWORD'],
                port=os.environ['REDIS_PORT'],
                db=1,
                decode_responses=True
            )
            # Uji apakah koneksi baru berhasil.
            if not _redis_connection.ping():
                raise Exception("Koneksi Redis gagal setelah dibuat.")
            return _redis_connection
        except Exception as e:
            print(f"Gagal menginisialisasi koneksi Redis: {e}")
            raise
    @app.route('/', defaults={'path': ''})
    @app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])
    def hello_world(path):
        try:
            r = getConnection()
            counter = r.get('counter')
            if counter is None:
                counter = 0
            else:
                counter = int(counter)
            print('counter: ' + str(counter))
            r.set('counter', str(counter + 1))
            return str(counter)
        except Exception as e:
            print(f"Terjadi kesalahan: {e}")
            return jsonify({"error": str(e)}), 500
    if __name__ == '__main__':
            app.run(host='0.0.0.0',port=9000)
    
  2. Di halaman detail fungsi, pilih tab Configuration. Temukan Advanced Settings dan klik Modify. Di panel Advanced Settings, temukan bagian Environment Variables dan konfigurasikan variabel berikut. Lalu, klik Deploy.

    Nama variabel lingkungan

    Nilai variabel lingkungan

    Deskripsi

    REDIS_HOST

    r-bp*****.redis.rds.aliyuncs.com

    Titik akhir instansiasi basis data. Jika Anda memilih skenario database Redis dalam VPC yang sama, atur variabel lingkungan ini ke titik akhir VPC database. Jika Anda memilih skenario database Redis lintas VPC atau wilayah, atur variabel lingkungan ini ke titik akhir publik database.

    Buka halaman Daftar Instans, pilih wilayah, lalu klik ID instans target. Di panel navigasi kiri, klik Informasi Instans. Di bagian Informasi Koneksi, temukan titik akhir database Anda.

    Jenis koneksi adalah Direct connection, dan nomor port adalah 6379.

    REDIS_PASSWORD

    *****

    Password database.

    REDIS_PORT

    6379

    Nomor port database

  3. Atur nilai awal di database Redis. Di halaman detail fungsi, pilih tab Code dan klik Test Function. Setelah eksekusi berhasil, periksa hasilnya.

    Di SQL Console Konsol DMS, jalankan perintah set counter 30 untuk mengatur nilai awal kunci string counter menjadi 30.

    Di tab Log output, Anda dapat melihat output counter: 30, yang menunjukkan bahwa fungsi berhasil mengakses Redis dan membaca nilai counter.

Informasi lebih lanjut

  • Untuk contoh tambahan mengakses Tair (Redis OSS-compatible), lihat Function Compute Python mengakses Tair (Redis OSS-compatible).

  • Untuk kasus pengecualian tambahan tentang mengakses Tair (Redis OSS-compatible), lihat Kesalahan umum.

  • Jika masalah pengecualian yang Anda temui belum terselesaikan, Anda perlu melakukan pemecahan masalah berdasarkan gejala yang muncul. Untuk informasi selengkapnya, lihat Penyebab umum kegagalan akses database.

  • Jika Anda ingin menggunakan tool baris perintah Serverless Devs untuk membuat fungsi dan mengakses database Tair (Redis OSS-compatible), ikuti langkah-langkah berikut.

    Klik di sini untuk melihat langkah-langkah operasi Serverless Devs

    1. Instal Serverless Devs dan Docker, lalu tambahkan informasi kunci. Untuk informasi selengkapnya, lihat Quick Start.

    2. Buat direktori kode bernama mycode, lalu buat file s.yaml dan file kode bernama app.py. Untuk kode contoh app.py, lihat kode yang disediakan di Langkah 2: Akses Redis dalam fungsi. Contoh file s.yaml ditunjukkan di bawah ini.

      Contoh s.yaml berikut berlaku untuk mengakses database Redis dalam VPC yang sama. Jika Anda perlu mengakses database lintas VPC atau wilayah, lihat Skenario 2: Akses database Redis lintas VPC atau wilayah.

      # ------------------------------------
      #   Dokumentasi resmi: https://manual.serverless-devs.com/user-guide/aliyun/#fc3
      #   Tips umum: https://manual.serverless-devs.com/user-guide/tips/
      #   Jika Anda memiliki pertanyaan, bergabunglah dengan grup DingTalk: 33947367
      # ------------------------------------
      edition: 3.0.0
      name: hello-world-app
      access: "default"
      vars: # Variabel global
        region: "cn-hangzhou"  # Jika Anda mengakses database dalam VPC yang sama, pastikan fungsi ditempatkan di wilayah yang sama dengan database.
      resources:
        hello_world:
          component: fc3 
          actions:       
            pre-${regex('deploy|local')}: 
              - component: fc3 build 
          props:
            region: ${vars.region}              
            functionName: "start-python-redis"
            runtime: custom.debian10
            description: 'hello world by serverless devs'
            timeout: 10
            memorySize: 512
            cpu: 0.5
            diskSize: 512
            code: ./code
            customRuntimeConfig:
              port: 9000
              command:
                - python3
                - app.py  
            internetAccess: true
            vpcConfig:
             vpcId: vpc-bp1dxqii29fpkc8pw**** # ID VPC instansiasi basis data.
             securityGroupId: sg-bp12ly2ie92ixrfc**** # ID security group.
             vSwitchIds: 
              - vsw-bp1ty76ijntee9z83**** # Pastikan Blok CIDR untuk vSwitch ini ada di daftar putih akses instansiasi basis data.
            environmentVariables:
              PYTHONPATH: /code/python
              PATH: /code/python/bin:/var/fc/lang/python3.10/bin:/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/opt/bin
              REDIS_HOST: r-bp*****.redis.rds.aliyuncs.com  # Titik akhir database.
              REDIS_PASSWORD: *****     # Password database.
              REDIS_PORT: "6379"         # Port database.
             

      Struktur direktori kode adalah sebagai berikut.

      ├── code
      │ ├── app.py
      │ └── requirements.txt
      └── s.yaml

      Dependensi yang ditentukan dalam file requirements.txt adalah sebagai berikut.

      flask==2.2.5
    3. Jalankan perintah berikut untuk mem-build proyek.

      sudo s build --use-docker
    4. Jalankan perintah berikut untuk mendeploy proyek.

      sudo s deploy -y
    5. Jalankan perintah berikut untuk memanggil fungsi.

      Catatan

      Pastikan Blok CIDR vSwitch yang dikonfigurasi untuk fungsi telah ditambahkan ke daftar putih akses instans database. Untuk informasi selengkapnya, lihat Langkah 4.

      sudo s invoke -e "{}"