Knative Functions, Knative üzerinde işlevler oluşturmak ve dağıtmak için basitleştirilmiş bir programlama modeli sunar; Knative, Kubernetes ve konteynerlerin birçok temel ayrıntısını gizler. Bir işlev oluşturduğunuzda sistem otomatik olarak konteyner görüntüsünü üretir. Görüntü oluşturma ve dağıtım parametrelerini özelleştirdikten sonra işlevi bir Knative Service olarak dağıtabilirsiniz.
Ön Koşullar
Kümenizde Knative dağıtılmış olmalıdır. Daha fazla bilgi için bkz. Knative bileşenlerini dağıtma ve yönetme.
Adım 1: Komut satırı aracını yükleyin
-
func sürüm sayfasından işletim sisteminize uygun
funcikili dosyasını indirin.Bu konuda func komut satırı aracının nasıl yükleneceği Linux kullanılarak gösterilmiştir.
-
İndirme tamamlandıktan sonra ikili dosyanın adını
funcolarak değiştirmek için aşağıdaki komutu çalıştırın.mv <path-to-binary-file> func # <path-to-binary-file> indicates the local path of the binary file, for example, func_darwin_amd64 or func_linux_amd64. -
İkili dosyaya çalıştırma izni vermek için aşağıdaki komutu çalıştırın.
chmod +x func -
Komutu her yerden çalıştırabilmeniz için func komutunu sistem PATH içindeki bir dizine taşımak üzere aşağıdaki komutu çalıştırın.
mv func /usr/local/bin -
func komut satırı aracının yüklendiğini doğrulamak için aşağıdaki komutu çalıştırın.
func versionYüklü func aracının sürüm bilgileri görüntülenirse komut satırı aracı başarıyla yüklenmiştir.
Adım 2: İşlev oluşturun
Knative Functions, birden çok dil ve çağırma yöntemi için şablonlar sağlar. CloudEvent ve HTTP çağrıları için aşağıdaki şablonlar kullanılabilir.
Aşağıdaki örnekte Go şablonu kullanılarak işlevin nasıl oluşturulacağı gösterilmiştir.
-
İşlev oluşturmak için aşağıdaki komutu çalıştırın.
func create -l <language> <function-name>Örneğin, Go dilinde örnek bir işlev oluşturun.
func create -l go helloBeklenen çıktı:
Created go function in /usr/local/bin/hello -
hellodizinindelskomutunu çalıştırarak oluşturulan proje dizinini görüntüleyin.func.yaml go.mod handle.go handle_test.go README.md -
hellodizininde otomatik olarak oluşturulan func.yaml dosyasını görüntülemek için aşağıdaki komutu çalıştırın.cat func.yamlBeklenen çıktı:
specVersion: 0.35.0 name: hello runtime: go created: 2023-12-13T06:48:45.419587147Z -
Daha sonra kullanmak üzere yapılandırma ve dağıtım parametrelerini özelleştirmek için func.yaml dosyasını düzenleyin. func.yaml dosyası işlev projesinin yapılandırma bilgilerini içerir. Ayrıntılar için bkz. func_yaml.md.
Aşağıda örnek bir func.yaml dosyası verilmiştir:
specVersion: 0.35.0 name: hello runtime: go created: 2023-11-29T14:47:34.101658+08:00 registry: registry.cn-beijing.aliyuncs.com/knative-release-xxx image: registry.cn-beijing.aliyuncs.com/knative-release-xxx/hello:latest build: builderImages: pack: registry-cn-beijing.ack.aliyuncs.com/acs/knative-func-builder-jammy-tiny:latest deploy: namespace: defaultregistry: Derlemeden sonra görüntünün gönderileceği hedef depo adresi.builderImages: Görüntü oluşturmak için kullanılan konteyner, örneğinregistry-cn-beijing.ack.aliyuncs.com/acs/knative-func-builder-jammy-tiny:latest.deploy: Ad alanı gibi dağıtımla ilgili yapılandırmalar.
Adım 3: Knative Functions'ı Dağıtın
Bir işlev oluşturduktan sonra Knative Functions'ı doğrudan dağıtabilirsiniz.
-
İşlev projesindeki işlevi dağıtmak için aşağıdaki komutu çalıştırın.
deployvarsayılan olarak işlev projesinin adını Knative Service adı olarak kullanır. İşlev derlendiğinde proje adı ve görüntü deposu adı kullanılarak işlevin tam görüntü adresi oluşturulur.func deploy -
İşlev dağıtım bilgilerini görüntülemek için aşağıdaki komutu çalıştırın.
func infoBeklenen çıktı:
Function name: hello Function is built in image: Function is deployed in namespace: default Routes: http://hello.default.example.com
Adım 4: Knative Functions'ı Çağırın
-
Hosts dosyasına bir giriş ekleyerek Knative erişim ağ geçidi adresini erişmek istediğiniz etki alanı adına eşleyin.
Aşağıda örnek bir eşleme verilmiştir.
121.xx.xxx.xx hello.default.example.com # 121.xx.xxx.xx: replace it with the gateway address of the Knative Service, and replace hello.default.example.com with your service domain name. -
İşlevi çağırmak için aşağıdaki komutu çalıştırın.
func invokeBeklenen çıktı:
POST / HTTP/1.1 hello.default.example.com Content-Type: application/json Forwarded: for=192.168.102.101;proto=http Knative-Serving-Default-Route: true X-Forwarded-Proto: http User-Agent: Go-http-client/1.1 Content-Length: 25 Accept-Encoding: gzip K-Proxy-Request: activator X-Forwarded-For: 192.168.102.101, 192.168.102.97 X-Request-Id: 3d82cfc8-f9df-4935-84cd-c6561b4587f6 Body:Beklenen çıktı, Knative Functions'a bir HTTP isteği gönderildiğini ve işlev çağrısının başarılı olduğunu gösterir.
-
Kümedeki podların durumunu görüntülemek için aşağıdaki komutu çalıştırın.
kubectl get podBeklenen çıktı:
NAME READY STATUS RESTARTS AGE hello-00001-deployment-7b65fcdc4c-gfcbp 2/2 Running 0 34Beklenen çıktı, işlev çağrısının bir pod oluşturmayı tetiklediğini gösterir.
Referanslar
Knative kullanırken karşılaşabileceğiniz yaygın sorunlar ve çözümleri için bkz. Knative SSS.