Pular para o conteúdo principal

Serverless - Conhecendo o Fn Project

Serverless com Fn Project


O projeto FN facilita a construção de plataformas serverless possibilitando o deploy de funções desenvolvidas em qualquer linguagem. Há ainda facilitadores que criam estrutura de projetos prontos em diversas linguagens, como Go, Ruby e Java. E Java, especificamente, ainda possui um framework (FN Java FDK) para facilitar o desenvolvimento.

Requisitos

Únicos pré-requisitos são ambiente Unix (Linux, Mac, etc.) e docker (17.10.0-ce ou superior) instalados. Para instalar o docker no Ubuntu Linux, siga o procedimento abaixo:

$ sudo apt install apt-transport-https ca-certificates curl software-properties-common
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
$ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu artful stable"
$ sudo apt update
$ sudo apt install docker-ce

Caso esteja utilizando Windows recomenda-se a utilização de uma máquina virtual, como o VirtualBox ou VMWare, para execução de um sistema operacional compatível.

Instalação

Valide se o docker está corretamente configurado:

$ docker --version

Se estiver corretamente configurado, deverá ser exibida a versão, algo como:

Docker version 18.03.1-ce, build 9ee9f40

Observação: dependendo da instalação do docker, pode ser necessário adicionar o comando sudo antes para executar com privilégios de administrador.

Para iniciar a instalação da plataforma Fn, basta executar o comando abaixo que será baixado o instalador e executado:

$ curl -LSs https://raw.githubusercontent.com/fnproject/cli/master/install | sh

Se a instalação tiver ocorrido normalmente, um logotipo com a versão do projeto deverá ser exibido:

fn version 0.4.123

______
/ ____/___
/ /_ / __ \
/ __/ / / / /
/_/ /_/ /_/`

Para iniciar a plataforma, basta digitar:

$ fn start

Novamente, para iniciar a plataforma, pode também ser necessário utilizar o comando sudo. A própria plataforma FN utiliza imagens docker.

Caso queira utilizar outra porta, é possível informar por parâmetro:

$ fn start -p 8081

Quando não é utilizada a porta padrão (8080) é necessário informar qual porta será utilizada, através da variável de ambiente FN_API_URL:

export FN_API_URL=http://127.0.0.1:8081

Para testar a instalação, basta executar o comando:

$ fn version

Deverá ser exibido além da versão do cliente, também a versão do servidor da plataforma:

Client version: 0.4.123
Server version:  0.3.506

Com tanto o fn client quanto fn server devidamente configurados, podemos iniciar nosso primeiro projeto.

Iniciando um projeto

Para iniciar um projeto java, basta utilizar o comando

$ fn init --runtime java [NOME DO PROJETO]

Será criada uma estrutura para o projeto:

├── func.yaml
├── hello.iml
├── pom.xml
└── src
    ├── main
    │   └── java
    │       └── com
    │           └── example
    │               └── fn
    │                   └── HelloFunction.java
    └── test
        └── java
            └── com
                └── example
                    └── fn
                        └── HelloFunctionTest.java


Notem que toda estrutura já foi criada, inclusive com classe de exemplo, respectivo teste e ainda um pom.xmlconfigurado para build com o maven.

Ao verificar o código, é possível ver que é bastante simples tratar uma requisição:

package com.example.fn;

public class HelloFunction {

    public String handleRequest(String input) {
        String name = (input == null || input.isEmpty()) ? "world"  : input;

        return "Hello, " + name + "!";
    }
}

Executando

Para executar o projeto como uma função dentro da plataforma FN, basta executar o comando

$ fn run

Observação: novamente cabe aqui alertar que dependendo da instalação que foi feita do docker, pode ser necessário preceder o comando por sudo.

Será então compilado o seu projeto e criada uma imagem com seu projeto, que será executado em seguida.

Se quiser passar um parâmetro, basta executar da seguinte maneira:

$ echo "Zeca" | fn run

E caso precise executar com sudo:

$ echo "Zeca" | sudo fn run

Estendendo funcionalidades

É possível facilmente tornar a funcionalidade mais completa, sem necessidade de novas dependências. Vamos ajustar a função para receber e retornar parâmetros JSON ao invés de simples Strings.

package com.example.fn;

public class HelloFunction {

    public static class Person {
        public String name;
    }

    public static class Result {
        public boolean authorized;
    }

    public Result handleRequest(Person person) {
        Result result = new Result();
        result.authorized = person.name.equalsIgnoreCase("zeca");
        return result;
    }
}

Para visualizar qualquer erro de compilação, basta executar com a opção --verbose:

$ fn --verbose run

Lembrando que por ter alterado a assinatura do serviço, é necessário ajustar os testes também:

package com.example.fn;

import com.fnproject.fn.testing.*;
import org.junit.*;

import static org.junit.Assert.*;

public class HelloFunctionTest {

    @Rule
    public final FnTestingRule testing = FnTestingRule.createDefault();

    @Test
    public void shouldReturnGreeting() {
        testing.givenEvent().withBody("{\"name\":\"Zeca\"}").enqueue();
        testing.thenRun(HelloFunction.class, "handleRequest");

        FnResult result = testing.getOnlyResult();
        assertEquals("{\"authorized\":true}", result.getBodyAsString());
    }

}

Deploy da imagem

Garanta que o build esteja funcionando corretamente:

$ fn build

Faça o deploy local da imagem:

$ fn deploy --local --app apps

Para executar, basta chamar através do protocolo http:

$ curl --data '{"name": "Zeca"}' http://localhost:8080/r/apps/myfunction

Siga em frente

Com isto temos uma primeira aplicação serverless configurada. Diversas áreas estão tirando proveito desta técnica que pode economizar recursos e ao mesmo tempo garantir a disponibilidade de uma funcionalidade acessada de forma não uniforme.
Este guia se baseou na documentação oficial do projeto. Seguem links:

Sobre o autor:

Full stack application developer with over 10 years of experience in developing enterprise applications. Passionate about deliver new features with high level of quality. Worked in important IT companies from Brazil.



Comentários

Postagens mais visitadas deste blog

Java Records

  Java Records Imutável, Simples e limpa Esta funcionalidade da linguagem apareceu pela primeira vez na versão 14 como experimental e assim continuou até a versão 15 . Agora liberada de forma definitiva no Java 16 . O objetivo é ser possível ter classes que atuam como portadores transparentes de dados imutáveis. Os registros podem ser considerados tuplas nominais. Ou seja, após criado, um record não pode mais ser alterado. Records oferece uma uma sintaxe compacta para declarar classes que são portadores transparentes para dados imutáveis superficiais visando reduzir significamente o detalhamento dessas classes e irá melhorar a capacidade de leitura e manutenção do código. Vamos seguir um exemplo de uma classe chamada Pessoa . O primeiro exemplo vamos utilizar o modo tradicional. public class Pessoa { private String nome; private int idade; public Pessoa (String nome, int idade) { super (); this .nome = nome; this .idade = idade; } public String getNo

Java 8 ao 18: Mudanças mais importantes na plataforma Java

    Vamos rever muitas das mudanças mais importantes na plataforma Java que aconteceram entre a versão 8 (2014) e 18 (2022)   O Java 8 foi lançado em março de 2014 e o Java 18 em março de 2022. São 8 anos de progresso, 203 JEPs (JDK Enhancement Proposals ), entre essas duas versões. Neste post, revisaremos as mudanças mais importantes e discutiremos os benefícios e desafios da adoção de versões mais recentes do JDK para novos aplicativos e para os mais antigos compilados com versões mais antigas. Desde a versão 9, o Java tem novos recursos a cada 6 meses e é muito difícil acompanhar essas novas mudanças. A maioria das informações na internet descreve as mudanças entre as duas últimas versões do Java. No entanto, se você estiver em uma situação semelhante à minha, não está usando uma das versões mais recentes do Java, mas uma das várias versões anteriores (Geralmente 8 ou 11 que são as versões de suporte estendido). Então é útil saber quais novos recursos foram adicionados d

O suporte de longo prazo e o que o LTS significa para o ecossistema Java

A arte do suporte de longo prazo e o que o LTS significa para o ecossistema Java Aqui está o que o Java 17 tem em comum com o Java 11 e o Java 8. Em junho de 2018, há pouco mais de três anos, a Oracle e outros participantes do ecossistema Java anunciaram uma mudança no modelo de cadência de lançamento para Java SE. Em vez de ter um lançamento principal planejado a cada dois ou quatro anos (que geralmente se torna de três a quatro anos), um novo modelo de lançamento de recursos de seis meses seria usado: a cada três anos, um lançamento seria designado como Long-Term Support (LTS) e receba apenas atualizações trimestrais de segurança, estabilidade e desempenho. Esse padrão foi emprestado descaradamente do modelo de lançamento do Mozilla Firefox, mas o ajustou para ficar mais alinhado com os requisitos de uma plataforma de desenvolvimento. A primeira versão do Java lançada sob esse modelo foi o Java SE 11. O lançamento do Java SE 17, o segundo lançamento do LTS sob o novo