Skip to content

Latest commit

 

History

History
103 lines (76 loc) · 3.33 KB

README.md

File metadata and controls

103 lines (76 loc) · 3.33 KB

Qfaas-setup

This repository contains steps to reproduce the QFaas project in a minikube cluster.
Visit the project QFaaS: Accelerating and Securing Serverless Cloud Networks with QUIC


Cluster Setup

See OpenFaas page for cluster options.


Install OpenFaas Community Edition using arkade(recommended)
# install arkade
curl -SLsf https://get.arkade.dev/ | sudo sh
arkade install openfaas

# install faas-cli
curl -SLsf https://cli.openfaas.com | sudo sh

# wait for succesful rollout status
kubectl rollout status -n openfaas deploy/gateway

# forward gateway svc port to 8080
kubectl port-forward -n openfaas svc/gateway 8080:8080 &

# If basic auth is enabled, you can now log into your gateway:
PASSWORD=$(kubectl get secret -n openfaas basic-auth -o jsonpath="{.data.basic-auth-password}" | base64 --decode; echo)
echo -n $PASSWORD | faas-cli login --username admin --password-stdin

Use Qfaas version of faas-netes

git clone https://github.com/qfaas-project/faas-netes.git
cd faas-netes
  1. Change the 1st line of Dockerfile, from FROM teamserverless/license-check:0.3.9 as license-check to FROM ghcr.io/openfaas/license-check:0.4.2 as license-check

  2. Now, build and push the docker image

export USERNAME="alexellis"
docker build -t $USERNAME/faas-netes:qfaas .
docker push $USERNAME/faas-netes:qfaas
  1. Run the arkade command with new faas-netes image
arkade install openfaas \
--set faasnetes.image=$USERNAME/faas-netes:qfaas

Deploy Hello-Retail

Test the hello-retail application on the original OpenFaas. Hello Retail

git clone https://github.com/qfaas-project/hello-retail.git 
cd hello-retail


NOTE: The repository requires minor edits to be made before usage.

  • Since deployed functions need to be pulled from dockerhub, set dockerhub credentials in your environment. See Private Registries for more info.

    export DOCKER_USERNAME=<your_docker_username>
    export DOCKER_PASSWORD=<your_docker_password>
    export DOCKER_EMAIL=<your_docker_email>
    
    # create the secret for dockerhub in openfaas-fn namespace
    kubectl create secret docker-registry dockerhub \
      -n openfaas-fn \
      --docker-username=$DOCKER_USERNAME \
      --docker-password=$DOCKER_PASSWORD \
      --docker-email=$DOCKER_EMAIL
    
  • in deploy/deploy_mysql.sh file, change the user password (pass to password) and run the script.

    kubectl run -n openfaas-fn --restart=Never --image=mysql:5.6 mysql-client-temp -- mysql -h mysql -ppassword -e "CREATE USER ..
    ./deploy_mysql.sh
    
  • in the functions/ folder, for each protocol subdirectory(tcp, tls, quic), edit the YAML files in all directories to reflect the following change for Gateway
    gateway: http://192.168.122.138:31112 to gateway: http://127.0.0.1:8080


Finally, run the Python script (pass protocol and action as paramaters):

python3 deploy_functions.py --protocol tcp --task deploy

You should now be able to invoke any of the deployed function using faas-cli invoke <function-name>