Deploy a flexible and highly available image processing service within 10 minutes

- 日理万妓 2022-02-13 06:11 70阅读 0赞

## Prefaces ##

Alibaba Cloud [Function Compute][] is an event-driven and fully-managed compute service. With Function Compute, you can quickly build any type of applications or services without considering management or O&M. You can complete a set of backend services for processing multimedia data even in several days. In this tutorial，we will deploy a flexible and highly avaliable image processing service in 10 minutes with FC.

## Image processing service example ##

Take the classic `lena` in image processing for example:  
![image][]

### The entry of image processing example： ###

*  reszie
    
     *  path：/resize/\[width\]/\[height\]/\[pic\_name\]
     *  [rezise example][]
 *  rotate:
    
     *  path：/rotate/\[angle\]/\[pic\_name\]
     *  [rotate example][]
 *  crop:
    
     *  path：/crop/\[left\]/\[top\]/\[right\]/\[bottom\]/\[pic\_name\]
     *  [crop example][]
 *  flip:
    
     *  path: /flip/\[pic\_name\]
     *  [flip example][]
 *  flop:
    
     *  path: /flip/\[pic\_name\]
     *  [flop example][]
 *  facedetect
    
     *  path: /face-detect/\[pic\_name\]
     *  [face-detect example][]
 *  composite(default demo):
    
     *  path: /
     *  [example defualt][]

### Effect Picture： ###

![image][image 1]

![image][image 2]

## Function Entry ##

We use python runtime to complete this tutorial. Let's look at a few concepts before we get started.

#### common handlers ####

def my_handler(event, context):
        return 'hello world'

*  Function name

The function name must match the “handler” field provided when a function is created. For example, if handler is specified as main.my\_handler, Function Compute obtains the my\_handler function defined in main.py.

*  Parameter event

The event parameter is defined when you call a function. In Python 2.7, this parameter is of str type. In Python 3, it is of bytes type. The parameter is an input parameter.

*  Parameter context

The context parameter contains information generated when the function is executed, for example, the request ID and temporary AccessKey credentials. You can use the generated information when coding. This parameter is of the FCContext type.

*  Return value

The return value of a function can be returned to the users as the result of invoke function. It can be any type. Function Compute can return it as str for simple type; and it can be returned as JSON str for complex type.

#### Handlers with an HTTP trigger ####

HELLO_WORLD = b"Hello world!\n"
    def handler(environ, start_response):
        context = environ['fc.context']
        status = '200 OK'
        response_headers = [('Content-type', 'text/plain')]
        start_response(status, response_headers)
        return [HELLO_WORLD]

*  environ : This parameter represents a Python dictionary that stores all client-related information. For more information, see [Parameter environ][]，Two user-defined keys, `fc.context` and `fc.request_uri`, are added to Function Compute.
    
     *  fc.context : functions as the [context][] parameter of common handlers.
     *  fc.request\_uri : indicates the URL of the request. This parameter is a string.

> Note: The `HTTP_Variables` field of environ contains the request header. For example, if the request header is `'x-Custom-key'`:`'value'`, the environ parameter will be environ\[`'HTTP_X_CUSTOM_KEY'`\] =`'value'`. According to WSGI, the key in the request header is processed as follows: `key = "HTTP_" + k.upper().replace("-","_")`.

*  start\_response: The start\_response callable is provided in runtime environments of Function Compute. It has two required positional parameters and one optional parameter. For more information, see the-start-response-callable. In the following example, the three parameters are named status, response\_headers, and exc\_info. You can use other names as needed.

More details can be found at [python handler][]

## Specific steps ##

Assuming that all the operations are finished in `Shenzhen(China south 1)` region, all the relevant resources can be download in the attachment.

There are two types of deployment:

1.  Use fun tools for automatic deployment
2.  Use fc console for visual deployment

### Preparations ###

*  Preparing pictures to the specified oss bucket

For example, build a bucket named `xiamen-ws` in `Shenzhen(China south 1)` region， where store the four pictures(you can casually name the bucket)

![image][image 3]

### Use the fun tool for automatic deployment ###

[Fun][] is a development tool for serverless applications. It can help you to efficiently arrange cloud resources such as Function Compute, API Gateway, Log Service and so on. You can use it to develop，build and deploy FC by describing relative resources in a template.yml file. The most basic serverless application can have only one function.

Take this case as example, the yaml file can be defined as follows:

ROSTemplateFormatVersion: '2015-09-01'
    Transform: 'Aliyun::Serverless-2018-04-03'
    Resources:
      image-demo-pro:
        Type: 'Aliyun::Serverless::Log'
        Properties:
          Description: 'image process log pro'
        fc-log:
          Type: 'Aliyun::Serverless::Log::Logstore'
          Properties:
            TTL: 362
            ShardCount: 1 
      
      image-service:
        Type: 'Aliyun::Serverless::Service'
        Properties:
          Description: 'image process demo'
          Policies:
            - AliyunOSSFullAccess
          LogConfig:
            Project: 'image-demo-pro'
            Logstore: 'fc-log'
        image-proc:
          Type: 'Aliyun::Serverless::Function'
          Properties:
            Handler: main.handler
            CodeUri: './'
            Description: 'image-process http function'
            Runtime: python2.7
            Timeout: 60
            MemorySize: 512
          Events:
            http-trigger:
              Type: HTTP
              Properties:
                AuthType: ANONYMOUS
                Methods: ['GET', 'POST', 'PUT']

Using the yaml file defined above, you can do the following:

1.  Create log resources: logproject:`image-demo-pro`, logstore:`fc-log`
2.  Create service: `image-service` and function: `image-proc`, configurating function with a trigger named http-trigger.
3.  Configurate service role and logconfig, role permission is `AliyunOSSFullAccess` and the authority of function execution log store into fc-log.

#### Specific deployment operation ####

*  Install nodejs (version>8)
 *  Install [fun][Fun]

npm install git://github.com/aliyun/fun.git --save -g

*  Modify the name of logproject and the related configuration in template.yml. After `fun deploy` has been executed successfully, you may see the following resources being crested, screenshot:

![image][image 4]  
![image][image 5]

### FC Console setup ###

#### Create service/function, and configurate http trigger ####

*  Create a new service, configurate service with the role of oss permission

![image][image 6]

![image][image 7]

*  Create function, and configurate Http trigger

![image][image 8]

![image][image 9]

![image][image 10]

![image][image 5]

## Summary ##

Function compute has advantages as follows:

*  No infrastructure - No need to purchase and manage server
 *  Focus on Business - Focusing on the development of business logic can greatly improve development efficiency
 *  Traceable - Provide log query, performance monitoring, alarm and other functions to quickly troubleshoot.
 *  Stable and Reliable - Stable , Highly availability, millisecond-level elastic scaling to cope up with peak demand pressure.
 *  Flexible Pricing - Pay-as-you-go, You only pay for the time your code runs. Function Compute is suitable for high traffic-fluctuation scenarios

[The official website of Function Compute][Function Compute]

[Function Compute]: https://www.alibabacloud.com/help/doc-detail/52895.htm
[image]: /images/20220213/03821e11707e402b8ca964c364bd02a0.png
[rezise example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/resize/128/128/lena.png
[rotate example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/rotate/60/lena.png
[crop example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/crop/50/50/300/300/lena.png
[flip example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/flip/lena.png
[flop example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/flop/lena.png
[face-detect example]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/face-detect/face.jpg
[example defualt]: http://1986114430573743.cn-shenzhen.fc.aliyuncs.com/2016-08-15/proxy/image-service/image-proc/
[image 1]: /images/20220213/d5ac0cdfa129459ba7dd6a83ff14e1cf.png
[image 2]: /images/20220213/f551ffcd2dc04e038cab1382d54637c0.png
[Parameter environ]: https://www.python.org/dev/peps/pep-3333/#environ-variables
[context]: https://www.alibabacloud.com/help/doc-detail/74756
[python handler]: https://www.alibabacloud.com/help/doc-detail/74756.htm
[image 3]: /images/20220213/ce2fc674f55d41ac803cbd15d62f0e16.png
[Fun]: https://github.com/aliyun/fun
[image 4]: /images/20220213/b9e4fe139e6f49089ddab3abda48ae04.png
[image 5]: /images/20220213/7c928a24624f4112ab23d87f30a9b247.png
[image 6]: /images/20220213/ecfef424788c464a89a8364d48659951.png
[image 7]: /images/20220213/60108f389e4e49e4be63d702c87ddf42.png
[image 8]: /images/20220213/91724fcf0a624c8287b7f70d41532944.png
[image 9]: /images/20220213/1480bdc45aba438ea527103ac22efd1d.png
[image 10]: /images/20220213/e2dfe1353b004c79bc6e5803e3e85ab2.png