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

Oracle JDK agora é livre?

    Olá Javeiros e Javeiras, h á uma boa notícia para todos os desenvolvedores Java e todos os clientes que usam Java sob uma licença comercial: o Oracle JDK está disponível gratuitamente a partir do JDK 17 ( publicado há poucos dias ). Novo modelo de licenciamento Informação retirada so site da Oracle : "Java 17 LTS é a versão de suporte de longo prazo mais recente para a plataforma Java SE. Os binários do JDK 17 podem ser usados gratuitamente na produção e podem ser redistribuídos, sem nenhum custo, de acordo com a Licença de Termos e Condições Gratuitas da Oracle ." O JDK 17 receberá atualizações sob esses termos, pelo menos até setembro de 2024. Confira a notícia completa: https://blogs.oracle.com/oracle-brasil/post/java-gratuito Esta licença gratuita inclui o JDK e as atualizações de segurança trimestrais também para uso comercial e de produção. A nova licença é a licença “Oracle No-Fee Terms and Conditions” (NFTC) e permite o uso gratuito para todos os usuários, m