מפעיל מגף קפיץ
מפעיל מגף קפיץ הוא תת-פרויקט של מסגרת אתחול האביב. הוא כולל מספר תכונות נוספות שעוזרות לנו לנטר ולנהל את אפליקציית Spring Boot. הוא מכיל את נקודות הקצה של המפעיל (המקום בו חיים המשאבים). אנחנו יכולים להשתמש HTTP ו JMX נקודות קצה לניהול וניטור אפליקציית Spring Boot. אם אנחנו רוצים לקבל תכונות מוכנות לייצור באפליקציה, עלינו להשתמש ב-S Pring Boot actuator.
תכונות מפעיל מגף קפיץ
יש שְׁלוֹשָׁה תכונות עיקריות של מפעיל אתחול קפיץ:
נקודת קצה: נקודות הקצה של המפעיל מאפשרות לנו לנטר ולקיים אינטראקציה עם האפליקציה. Spring Boot מספק מספר נקודות קצה מובנות. אנחנו יכולים גם ליצור נקודת קצה משלנו. אנו יכולים להפעיל ולנטרל כל נקודת קצה בנפרד. רוב היישום לבחור HTTP , שבו המזהה של נקודת הקצה, יחד עם הקידומת של /מַפעִיל, ממופה לכתובת אתר.
10 מ"ל לאונקים
לדוגמה, ה /בְּרִיאוּת נקודת הקצה מספקת את המידע הבריאותי הבסיסי של יישום. המפעיל, כברירת מחדל, מייפה אותו ל /מפעיל/בריאות .
מדדים: מפעיל קפיצי אתחול מספק מדדי מימד על ידי שילוב עם מִיקרוֹמֶטֶר . המיקרומטר משולב ב-Spring Boot. זוהי ספריית המכשור המניעה את אספקת מדדי האפליקציה מ-Spring. הוא מספק ממשקים ניטרליים לספק עבור טיימרים, מדדים, מונים, סיכומי הפצה, ו טיימרים ארוכים של משימות עם מודל נתונים ממדי.
בְּדִיקָה: Spring Boot מספק מסגרת ביקורת גמישה המפרסמת אירועים ל- AuditEventRepository. זה מפרסם אוטומטית את אירועי האימות אם ה-Spring-Security מופעלת.
הפעלת מפעיל קפיצי אתחול
אנו יכולים להפעיל מפעיל על ידי הזרקת התלות קפיץ-אתחול-מתנע-מפעיל בקובץ pom.xml.
org.springframework.boot spring-boot-starter-actuator 2.2.2.RELEASE
נקודות קצה של מפעיל מגף קפיץ
נקודות הקצה של המפעיל מאפשרות לנו לנטר ולקיים אינטראקציה עם אפליקציית Spring Boot שלנו. Spring Boot כולל מספר נקודות קצה מובנות ונוכל להוסיף גם נקודות קצה מותאמות אישית באפליקציית Spring Boot.
הטבלה הבאה מתארת את נקודות הקצה בשימוש נרחב.
תְעוּדַת זֶהוּת | נוֹהָג | בְּרִירַת מֶחדָל |
---|---|---|
מַפעִיל | הוא מספק מדיה מבוססת דף גילוי עבור שאר נקודות הקצה. זה מחייב את Spring HATEOAS להיות במסלול הכיתה. | נָכוֹן |
אירועי ביקורת | הוא חושף מידע על אירועי ביקורת עבור היישום הנוכחי. | נָכוֹן |
תצורה אוטומטית | הוא משמש להצגת דוח תצורה אוטומטית המציג את כל המועמדים לתצורה האוטומטית ואת הסיבה שבגללה הם 'היו' או 'לא הוחלו'. | נָכוֹן |
שעועית | הוא משמש להצגת רשימה מלאה של כל שעועית האביב באפליקציה שלך. | נָכוֹן |
configprops | הוא משמש להצגת רשימה אסופה של כל @ConfigurationProperties. | נָכוֹן |
מזבלה | הוא משמש לביצוע השלכת חוטים. | נָכוֹן |
env | הוא משמש לחשיפת מאפיינים מה-ConfigurableEnvironment של Spring. | נָכוֹן |
דרך טיסה | הוא משמש להצגת כל העברת מסדי נתונים של Flyway שהוחלו. | נָכוֹן |
בְּרִיאוּת | הוא משמש להצגת מידע על בריאות היישום. | שֶׁקֶר |
מידע | הוא משמש להצגת מידע יישום שרירותי. | שֶׁקֶר |
כורתי עצים | הוא משמש כדי להציג ולשנות את התצורה של לוגרים באפליקציה. | נָכוֹן |
liquibase | הוא משמש להצגת כל הגירות של מסד נתונים של Liquibase שהוחלו. | נָכוֹן |
מדדים | הוא משמש להצגת מידע מדדים עבור האפליקציה הנוכחית. | נָכוֹן |
מיפויים | הוא משמש להצגת רשימה אסופה של כל הנתיבים @RequestMapping. | נָכוֹן |
לכבות | הוא משמש כדי לאפשר לאפליקציה להיסגר בחן. | נָכוֹן |
זֵכֶר | הוא משמש להצגת מידע מעקב. | נָכוֹן |
עבור Spring MVC, נעשה שימוש בנקודות הקצה הנוספות הבאות.
תְעוּדַת זֶהוּת | תיאור | בְּרִירַת מֶחדָל |
---|---|---|
מסמכים | הוא משמש להצגת תיעוד, כולל בקשות ותגובות לדוגמה עבור נקודות הקצה של המפעיל. | שֶׁקֶר |
ערימה | הוא משמש להחזרת קובץ dump hprof heap דחוס של GZip. | נָכוֹן |
jolokia | הוא משמש לחשיפת שעועית JMX דרך HTTP (כאשר Jolokia נמצאת בנתיב הכיתה). | נָכוֹן |
קובץ לוג | הוא משמש להחזרת התוכן של קובץ היומן. | נָכוֹן |
פרומתאוס | הוא משמש לחשיפת מדדים בפורמט שניתן לגרד על ידי שרת פרומתאוס. זה דורש תלות במיקרומטר-רישום- פרומתאוס. | נָכוֹן |
תכונות מפעיל של Spring Boot
Spring Boot מאפשר אבטחה לכל נקודות הקצה של המפעיל. זה משתמש מבוססי טפסים אימות המספק זהות המשתמש כמשתמש ויוצר באופן אקראי סיסמה . אנחנו יכולים גם לגשת לנקודות קצה מוגבלות על ידי התאמה אישית של אבטחת אימות בסיסית לנקודות הקצה. אנחנו צריכים לעקוף את התצורה הזו על ידי תפקידי.ניהול.אבטחה תכונה. לדוגמה:
management.security.enabled=true management.security.roles=ADMIN security.basic.enabled=true security.user.name=admin security.user.passowrd=admin
דוגמה למפעיל מגף קפיץ
בואו נבין את הרעיון של המפעיל באמצעות דוגמה.
שולחנות בלטקס
שלב 1: Open Spring Initializr https://start.spring.io/ וליצור א מייבן פּרוֹיֶקט.
שלב 2: ספק את קְבוּצָה שֵׁם. סיפקנו com.javatpoint.
שלב 3: ספק את חפץ תְעוּדַת זֶהוּת. סיפקנו את קפיץ-מגף-מפעיל-דוגמה.
שלב 4: הוסף את התלות הבאות: Spring Web, Spring Boot Starter Actuator, ו Spring Data Rest דפדפן HAL .
יצירת טבלאות בלטקס
שלב 5: הקלק על ה לִיצוֹר לַחְצָן. כאשר אנו לוחצים על כפתור Generate, הוא עוטף את כל המפרטים הקשורים לפרויקט לתוך א קַנקַן קובץ ומוריד אותו למערכת המקומית שלנו.
שלב 6: חלץ את קובץ Jar והדבק אותו בסביבת העבודה של STS.
שלב 7: ייבא את תיקיית הפרויקט.
קובץ -> ייבוא -> פרויקטים קיימים של מייבן -> עיון -> בחר בתיקייה spring-boot-actuator-example -> סיום
זה לוקח קצת זמן לייבא. לאחר ייבוא הפרויקט, נוכל לראות את ספריית הפרויקט בקטע סייר החבילות.
שלב 8: צור כיתת Controller. יצרנו את מחלקת הבקר עם השם DemoRestController.
DemoRestController.java
np.mean
package com.javatpoint; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController public class DemoRestController { @GetMapping('/hello') public String hello() { return 'Hello User!'; } }
שלב 9: פתח את ה application.properties קובץ והשבת את תכונת האבטחה של המפעיל על ידי הוספת ההצהרה הבאה.
application.properties
management.security.enabled=false
שלב 10: הפעל את SpringBootActuatorExampleApplication.java קוֹבֶץ.
שלב 11: פתח את הדפדפן והפעל את כתובת האתר http://localhost:8080/actuator. זה מחזיר את העמוד הבא:
{'_links':{'self':{'href':'http://localhost:8080/actuator','templated':false},'health':{'href':'http://localhost:8080/actuator/health','templated':false},'health-path':{'href':'http://localhost:8080/actuator/health/{*path}','templated':true},'info':{'href':'http://localhost:8080/actuator/info','templated':false}}}
היישום פועל על יציאה 8080 כברירת מחדל. לאחר שהמפעיל התחיל, נוכל לראות את רשימת כל נקודות הקצה שנחשפו ב-HTTP.
b פלוס עץ
בואו נפעיל את בְּרִיאוּת נקודת קצה על ידי הפעלת כתובת האתר http://localhost:8080/actuator/health. זה מציין את הסטטוס לְמַעלָה . זה אומר שהאפליקציה בריאה ופועלת ללא כל הפרעה.
באופן דומה, אנו יכולים להפעיל נקודות קצה אחרות שעוזרות לנו לנטר ולנהל את אפליקציית Spring Boot.
הורד את הפרויקט