Function Compute:İşlev örneği yaşam döngüsü kancaları

Nasıl çalışır?

Bir işlev örneği üç aşamadan geçer:

• Başlatma: Function Compute bir örneği oluşturduğunda veya dondurulmuş durumdan çıkardığında, trafiği örneğe yönlendirmeden önce (yapılandırılmışsa) Initializer kancasını çağırır. İlk istekten önce tamamlanması gereken kurulum işlemlerini (model yükleme, bağlantı havuzlarını hazırlama vb.) yapmak için bu aşamayı kullanın.

• Çalıştırma: Örnek, işlev çağrılarını işler. Ana işleyici, istekleri iş mantığınıza yönlendirir.

• Kapatma: Function Compute bir örneği dondurmadan veya yok etmeden önce (yapılandırılmışsa) PreStop kancasını çağırır. Arabellekleri temizlemek, bağlantıları kapatmak veya kaynakları serbest bırakmak için bu aşamayı kullanın.

Yaşam döngüsü kancaları, normal çağrılarla aynı oranda faturalandırılır. Bu kancaların günlükleri Function Logs ve Advanced Logs bölümünde görüntülenir ancak Invocation Requests listesinde yer almaz.

Örnek yaşam döngüsü yapılandırması hakkında genel bilgi için bkz. Örnek yaşam döngüsünü yapılandırma.

Kanca arayüzü referansı

Özel çalışma zamanı HTTP sunucunuz aşağıdaki uç noktaları sunmalıdır:

Her iki kanca da x-fc-request-id dahil olmak üzere ortak istek üst bilgilerini alır.

Yaşam döngüsü kancalarını uygulayın

Aşağıdaki Python 3.10 Flask örneği, tek bir HTTP sunucusunda üç uç noktanın tümünü göstermektedir: Initializer kancası, ana çağrı işleyicisi ve PreStop kancası.

import os
from flask import Flask, request

app = Flask(__name__)

# Initializer hook — runs once when the instance starts
@app.route('/initialize', methods=['POST'])
def init_invoke():
    rid = request.headers.get('x-fc-request-id')
    print("FC Initialize Start RequestId: " + rid)
    # Add setup logic here: load models, open connections, etc.
    print("FC Initialize End RequestId: " + rid)
    return "OK"

# Main invocation handler
@app.route('/', defaults={'path': ''})
@app.route('/<path:path>', methods=['GET', 'POST', 'PUT', 'DELETE'])
def hello_world(path):
    rid = request.headers.get('x-fc-request-id')
    print("FC invoke Start RequestId: " + rid)
    # Add business logic here
    print("FC invoke End RequestId: " + rid)
    return "Hello, World!", 200, [('Function-Name', os.getenv('FC_FUNCTION_NAME'))]

# PreStop hook — runs before the instance is frozen or destroyed
@app.route('/pre-stop', methods=['GET'])
def prestop_invoke():
    rid = request.headers.get('x-fc-request-id')
    print("FC PreStop Start RequestId: " + rid)
    # Add cleanup logic here: flush buffers, close connections, etc.
    print("FC PreStop End RequestId: " + rid)
    return "OK"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=9000)

PreStop kancası, Initializer kancasıyla aynı uygulama desenini takip eder.

# Scenario 1: unhandled exception
@app.route('/initialize', methods=['POST'])
def init():
    raise Exception("initialization failed")
    return "OK", 200, []

# Scenario 2: explicit non-2xx response
@app.route('/initialize', methods=['POST'])
def init():
    return "OK", 404, []

Hata yönetimi

Function Compute, hangi kancanın başarısız olduğuna ve döndürülen durum koduna bağlı olarak hatalara farklı şekilde yanıt verir.

Yaşam döngüsü kancalarını yapılandırın

1. Function Compute konsoluna giriş yapın. Sol gezinme bölmesinde Functions seçeneğine tıklayın.

2. Üst gezinme çubuğunda bir bölge seçin. Functions sayfasında yapılandırmak istediğiniz işleve tıklayın.

3. Configuration sekmesine tıklayın. Instance Configuration bölümünde Modify seçeneğine tıklayın.

4. Instance Configuration panelinde kanca türünü ve zaman aşımı süresini ayarlayın, ardından Deploy seçeneğine tıklayın.

5. Kodunuzda kanca mantığını uygulayın. Kod düzenleyicisinin üzerindeki Deploy seçeneğine tıklayın, sonra Test Function seçeneğine tıklayın.

Yaşam döngüsü kancası günlüklerini görüntüleyin

1. Function Compute konsoluna giriş yapın. Sol gezinme bölmesinde Functions seçeneğine tıklayın.

2. Bir bölge seçin ve incelemek istediğiniz işleve tıklayın.

3. Test sekmesine tıklayın, Test Function seçeneğine tıklayın, ardından Logs > Function Logs yolunu izleyin.

Function Logs bölümü, çağrı günlüklerini ve Initializer kancası günlüklerini kronolojik sırayla gösterir. Aşağıdaki örnekte bir Initializer çalıştırmasının ardından bir işlev çağrısı görülmektedir:

2024-06-26 10:59:23FC Initialize Start RequestId: 529eab23-9b3a-4ffc-88c8-9a686*******
2024-06-26 10:59:23FC Initialize End RequestId: 529eab23-9b3a-4ffc-88c8-9a686*******
2024-06-26 10:59:25FC Invoke Start RequestId: 1-667b840c-15c49df0-b7dc1*******
2024-06-26 10:59:25FC Invoke End RequestId: 1-667b840c-15c49df0-b7dc1*******

Function Compute, örneği yok etmeden önce bir süre önbellekte tuttuğu için PreStop kancası günlükleri hemen görünmeyebilir. PreStop kancasını isteğe bağlı olarak tetiklemek için işlevin yapılandırmasını veya kodunu güncelleyin, ardından Function Logs bölümünü kontrol edin:

2024-06-26 11:04:33FC PreStop Start RequestId: c4385899-f071-490e-a8b7-e33c5*******
2024-06-26 11:04:33FC PreStop End RequestId: c4385899-f071-490e-a8b7-e33c5*******