VT2018 OpenWhisk Demo - Revision history

Donsez: /* Compilation */

2018-11-12T15:28:31Z

Compilation

← Older revision		Revision as of 15:28, 12 November 2018
Line 55:		Line 55:

	On la compile avec la commande suivante :		On la compile avec la commande suivante :
	javac -classpath '''PATH'''/gson-2.8.5.jar fact.java		javac -classpath '''$PATH'''/gson-2.8.5.jar fact.java
	Ici, la valeur '''<code>PATH</code>''' est à remplacer par le chemin où vous avez rangé la librairie [https://github.com/google/gson Gson] qui est nécessaire pour utiliser du Java avec OpenWhisk.		Ici, la valeur '''<code>PATH</code>''' est à remplacer par le chemin où vous avez rangé la librairie [https://github.com/google/gson Gson] qui est nécessaire pour utiliser du Java avec OpenWhisk.

Servan.Charlot: /* Utilisation */

2018-11-02T13:18:21Z

Utilisation

← Older revision		Revision as of 13:18, 2 November 2018
Line 79:		Line 79:
	'''lien'''?num=10		'''lien'''?num=10

	On ajoute ensuite notre action à une API (ce qui crée l'API si elle n'existe pas déjà). Cela peut être ~~faire~~ depuis la dashboard ou en utilisant la commande suivante :		On ajoute ensuite notre action à une API (ce qui crée l'API si elle n'existe pas déjà). Cela peut être fait depuis le dashboard ou en utilisant la commande suivante :
	bx wsk api create /fact GET fact		bx wsk api create /fact GET fact
	Cette commande nous indique que l'API à été crée et nous donne sa route :		Cette commande nous indique que l'API à été crée et nous donne sa route :

Servan.Charlot: /* Compilation */

2018-11-02T13:16:46Z

Compilation

← Older revision		Revision as of 13:16, 2 November 2018
Line 56:		Line 56:
	On la compile avec la commande suivante :		On la compile avec la commande suivante :
	javac -classpath '''PATH'''/gson-2.8.5.jar fact.java		javac -classpath '''PATH'''/gson-2.8.5.jar fact.java
	Ici, la valeur '''<code>PATH</code>''' est à remplacer par le chemin ou vous avez rangé la ~~libraire~~ [https://github.com/google/gson Gson] qui est nécessaire pour utiliser du Java avec OpenWhisk.		Ici, la valeur '''<code>PATH</code>''' est à remplacer par le chemin où vous avez rangé la librairie [https://github.com/google/gson Gson] qui est nécessaire pour utiliser du Java avec OpenWhisk.

	On crée ensuite une archive jar de notre action compilée :		On crée ensuite une archive jar de notre action compilée :

Servan.Charlot: /* Développement */

2018-11-02T13:15:59Z

Développement

← Older revision		Revision as of 13:15, 2 November 2018
Line 50:		Line 50:
	</source>		</source>

	Cette action est toute simple : Elle ~~prends~~ un objet JSON en paramètre, renvoie une objet JSON en sortie, et exécute une factorielle.		Cette action est toute simple : Elle prend un objet JSON en paramètre, renvoie une objet JSON en sortie, et exécute une factorielle.

	==Compilation==		==Compilation==

Servan.Charlot: /* Préparation */

2018-11-02T13:14:49Z

Préparation

← Older revision		Revision as of 13:14, 2 November 2018
Line 7:		Line 7:
	=Préparation=		=Préparation=

	Il faut d'abord ~~crée~~ un compte sur le [https://console.bluemix.net/openwhisk Cloud IBM Bluemix] pour avoir accès au dashboard qui permet de gérer les actions et les API.		Il faut d'abord créer un compte sur le [https://console.bluemix.net/openwhisk Cloud IBM Bluemix] pour avoir accès au dashboard qui permet de gérer les actions et les API.

	La majorité des fonctionnalités sont disponibles sur le dashboard, mais l'on va avoir besoin de certaines qui n'y sont pas. Il faut donc installer [https://console.bluemix.net/openwhisk/learn/cli l'interface de ligne de commande IBM Cloud Functions].		La majorité des fonctionnalités sont disponibles sur le dashboard, mais l'on va avoir besoin de certaines qui n'y sont pas. Il faut donc installer [https://console.bluemix.net/openwhisk/learn/cli l'interface de ligne de commande IBM Cloud Functions].

Servan.Charlot: /* Description */

2018-11-02T13:13:47Z

Description

← Older revision		Revision as of 13:13, 2 November 2018
Line 3:		Line 3:
	Ceci est la demonstration qui va avec la [[VT2018 OpenWhisk\|fiche de synthèse]] sur [[OpenWhisk]] dans le cadre de la [[VT2018\|veille technologique 2018]].		Ceci est la demonstration qui va avec la [[VT2018 OpenWhisk\|fiche de synthèse]] sur [[OpenWhisk]] dans le cadre de la [[VT2018\|veille technologique 2018]].

	Nous allons utiliser la technologie OpenWhisk présente sur le Cloud d'IBM pour ~~crée~~ une action/fonction, l'envoyer sur le Cloud et l'appeler grâce à une API.		Nous allons utiliser la technologie OpenWhisk présente sur le Cloud d'IBM pour créer une action/fonction, l'envoyer sur le Cloud et l'appeler grâce à une API.

	=Préparation=		=Préparation=

Servan.Charlot: Created page with "=Description= Ceci est la demonstration qui va avec la fiche de synthèse sur OpenWhisk dans le cadre de la veille technologique 2018. No..."

2018-11-02T13:12:32Z

Created page with "=Description= Ceci est la demonstration qui va avec la fiche de synthèse sur OpenWhisk dans le cadre de la veille technologique 2018. No..."

New page

=Description=

Ceci est la demonstration qui va avec la [[VT2018 OpenWhisk|fiche de synthèse]] sur [[OpenWhisk]] dans le cadre de la [[VT2018|veille technologique 2018]].

Nous allons utiliser la technologie OpenWhisk présente sur le Cloud d'IBM pour crée une action/fonction, l'envoyer sur le Cloud et l'appeler grâce à une API.

=Préparation=

Il faut d'abord crée un compte sur le [https://console.bluemix.net/openwhisk Cloud IBM Bluemix] pour avoir accès au dashboard qui permet de gérer les actions et les API.

La majorité des fonctionnalités sont disponibles sur le dashboard, mais l'on va avoir besoin de certaines qui n'y sont pas. Il faut donc installer [https://console.bluemix.net/openwhisk/learn/cli l'interface de ligne de commande IBM Cloud Functions].
Il s'agit d'une surcouche aux commandes de base d'[http://openwhisk.incubator.apache.org/documentation.html OpenWhisk], avec le nécessaire pour lier notre compte IBM Cloud au terminal.

=Déroulement=

==Développement==

On commence par écrire l'action qui nous intéresse, ici en Java (mais d'autres langages sont utilisables).

<source lang="java" line start="1">
import com.google.gson.JsonObject;

public class fact {

public static double myfact(double n) {
if (n == 0)
return 1.0;
else
return n * myfact(n - 1);
}

public static JsonObject main(JsonObject args) {
double num;
double result;

try {
num = args.getAsJsonPrimitive("num").getAsDouble();
} catch (Exception e) {
num = 0;
}

result = myfact(num);

JsonObject response = new JsonObject();
response.addProperty("YourNumber", num);
response.addProperty("result", result);
return response;
}
}
</source>

Cette action est toute simple : Elle prends un objet JSON en paramètre, renvoie une objet JSON en sortie, et exécute une factorielle.

==Compilation==

On la compile avec la commande suivante :
javac -classpath '''PATH'''/gson-2.8.5.jar fact.java
Ici, la valeur '''<code>PATH</code>''' est à remplacer par le chemin ou vous avez rangé la libraire [https://github.com/google/gson Gson] qui est nécessaire pour utiliser du Java avec OpenWhisk.

On crée ensuite une archive jar de notre action compilée :
jar cvf fact.jar fact.class

==Utilisation==

On envoie ensuite notre action sur le cloud avec la commande suivante :
bx wsk action create fact fact.jar --main fact --web true
Il est important de spécifier le nom de la classe principale avec l'option <code>--main MainClass</code>.

L'option <code>--web true</code> permet de créer une [https://console.bluemix.net/docs/openwhisk/openwhisk_webactions.html#openwhisk_webactions web action], qui peut être déclenchée par une API (ce n'est pas la cas par défaut). A noter que cela peut être fait ultérieurement sur le dashboard.

Même si notre action n'est pour le moment liée à aucune API, on peux déjà la tester sur le dashboard ou avec la commande suivant :
bx wsk action invoke fact --result --param num 10
Ce qui doit nous retourner le résultat suivant :
{
"YourNumber": 10.0,
"result": 3628800.0
}
On a la possibilité de récupérer un [https://openwhisk.eu-gb.bluemix.net/api/v1/web/NailedItLaboratories_dev/default/fact.json lien] sur le dashboard pour pouvoir l’exécuter dans un navigateur ou avec <code>curl</code>. Il faudra ajouter les paramètres suivants à ce lien :
'''lien'''?num=10

On ajoute ensuite notre action à une API (ce qui crée l'API si elle n'existe pas déjà). Cela peut être faire depuis la dashboard ou en utilisant la commande suivante :
bx wsk api create /fact GET fact
Cette commande nous indique que l'API à été crée et nous donne sa route :
ok: created API /fact GET for action /_/fact
https://service.eu.apiconnect.ibmcloud.com/gws/apigateway/api/d11b1723f811a8252e0f99cbc363d55547a42626ea62d836a2f4e0844dc944b4/fact
On peut maintenant appeler cette API dans un navigateur ou avec <code>curl</code> avec les paramètres suivants :
'''route'''?num=10