Spring cloud netflix
@ DTSI
Focus Zuul / hystrix
Rappel architecture
A quoi ça sert ? (1/2)
Zuul
Ou le routage dit "intelligent" en environnements distribués.
Plus besoin de savoir où les services sont physiquement installés. Zuul a un double rôle routeur / répartiteur de charge et va s'appuyer sur l'annuaire de services Euréka pour propager les appels de services.
A quoi ça sert ? (2/2)
Ou comment réagir, en environnements distribués, à l'éventuelle indisponibilité d'un ou de plusieurs services tiers.
Hystrix est une implémentation du pattern Circuit Breaker. Il s'agit ici de continuer à rendre un service en mode dit dégradé dans vos applications lorsque le service original renvoie un trop grand nombre d'erreurs.
Et si on ne fait rien ?
RAPPEL(s) :
L'utilisation de Zuul est obligatoire lorsque votre application utilise des services tiers (externes à ladite application).
Les (micro-) services qui sont utilisés par plus d'une applications doivent obligatoirement s'enregistrer sur l'annuaire de services Euréka.
Première démo
Première démo
Dans un environnement tel que défini à la DTSI (sauf Spring Cloud Config) :
- Spring Boot Admin
- Spring Cloud Netflix Eureka (deux instances répliquées)
- Déploiement d'un micro-service exposant le référentiel ISO des pays, et donc référencé dans l'annuaire de service Euréka)
- Déploiement d'une application d'inscription : backend Spring Boot et frontend Angular
Le projet de démonstration est disponible ici.
Première démo
Comment faire ? (1/3)
Dans l'application utilisatrice de services transverses :
Ajouter les dépendances :
<dependencies>
(...)
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>
(...)
</dependencies>Comment faire ? (2/3)
Dans l'application utilisatrice de services transverses :
Modifier la classe de bootstrap de votre application en lui ajoutant les annotations :
@EnableDiscoveryClient
@EnableZuulProxy
Il y a plusieurs implémentations pour la découverte des services : eureka, consul, zookeeper...
Il est donc possible d'utiliser l'annotation générique @EnableDiscoveryClient (Spring Cloud Commons), ou l'annotation spécifique @EnableEurekaClient (Spring Cloud Netflix).
Comment faire ? (3/3)
Dans l'application utilisatrice de services transverses :
Ajouter les éléments de configuration :
eureka:
client:
serviceUrl:
defaultZone: http://vbl-dva-xubuntu15.dev.gnc:10300/eureka/ \
,http://vbl-dva-xubuntu15.dev.gnc:10301/eureka/
region: dev.gnc
registerWithEureka: false
zuul:
ignoredServices: '*'
routes:
countries:
path: /api/v1/countries/**
serviceId: MS-Countries
strip-prefix: falseEt si le service ne repond plus ?
DEUXIEME Démo
- Coupure du service du référentiel ISO 3166 des pays.
- Observation du comportement de l'application.
Que se passe-t'il ?
Troisième démo
- Re-démarrage du référentiel des pays
- Re-démarrage de l'application cliente dans une version prenant en charge la protection de l'appel au référentiel des pays
- Observation du comportement de l'application
Troisième démo
Que se passe-t'il ?
Mais c'est normal, puisque nous sommes revenus dans la situation d'origine : le service tiers est en fonctionnement...
Et si on coupe de nouveau ledit service ?
Quatrième démo
Comment faire ? (1/3)
Dans l'application utilisatrice de services transverses :
Ajouter un Bean de Configuration qui implémente ZuulFallbackProvider.
Attention, ce n'est pas possible pour les versions de Spring - et dépendances associées - inférieures ou égales à Camden.SR1 !
Comment faire ? (2/3)
package nc.dva.examples.hystrix;
import ...;
@Configuration
public class PlayerCountryFallbackConfiguration {
@Bean
public ZuulFallbackProvider zuulFallbackProvider() {
return new ZuulFallbackProvider() {
@Autowired
private PlayerRepository lPlayerRepository;
@Override
public String getRoute() {
// Might be confusing: it's the serviceId property and not the
// route!!!
// Be carefull !
return "MS-Countries";
}
@Override
public ClientHttpResponse fallbackResponse() {
return new ClientHttpResponse() {
@Override
public HttpStatus getStatusCode() throws IOException {
return HttpStatus.OK;
}
@Override
public int getRawStatusCode() throws IOException {
return HttpStatus.OK.value();
}
Comment faire ? (3/3)
@Override
public String getStatusText() throws IOException {
return HttpStatus.OK.toString();
}
@Override
public void close() {
}
@Override
public InputStream getBody() throws IOException {
List<String> localCountries = lPlayerRepository.findCountries();
List<Country> result = new ArrayList<Country>();
for (String codeIso3 : localCountries) {
Country lCountry = new Country(codeIso3, codeIso3);
result.add(lCountry);
}
return new ByteArrayInputStream(new Gson().toJson(result).getBytes());
}
@Override
public HttpHeaders getHeaders() {
HttpHeaders headers = new HttpHeaders();
headers.setContentType(MediaType.APPLICATION_JSON);
headers.setAccessControlAllowOrigin("*");
return headers;
}
};
}
};
}
}
package nc.dva.examples.hystrix;
public class Country {
private String codeIso3;
private String libelleCOG;
(...)
}
HYSTRIX Dashboard
The icing on the cake !
Le résultat est ici assez pauvre, mais le tableau de bord permet, pour chaque service monitoré, de vérifier l'état du circuit - au sens du pattern Circuit Breaker.
Comment faire ?
Tout se passe dans l'application Spring Boot Admin !
Ajouter, dans le fichier pom.xml, la dépendance :
<dependency>
<groupId>de.codecentric</groupId>
<artifactId>spring-boot-admin-server-ui-hystrix</artifactId>
<version>${spring-boot-admin.version}</version>
</dependency>Ajouter, dans le fichier de configuration de l'application :
spring:
boot:
admin:
routes:
endpoints: env,metrics,trace,dump,jolokia,info,configprops,trace,logfile,refresh, \
flyway,heapdump,loggers,auditevents,hystrix.streamVérification
Sur la page About de Spring Boot Admin : vous devez trouver sba-applications-hystrix dans la liste Loaded ui modules.
Toujours dans Spring Boot Admin, sur la page Détail de l'application concernée, vous devez trouver un nouvel onglet Hystrix qui vous donne accès au tableau de bord Hystrix (cf. copie d'écran supra).
Merci de votre attention
Questions / Débat
Spring cloud Zuul & Hystrix @ DTSI
By Didier Vanderstoken
