streamalism.org

1. סקירה כללית

יישומי רשת Spring Boot כוללים כברירת מחדל שרת אינטרנט שהוגדר מראש. אולם במצבים מסוימים נרצה שנה את תצורת ברירת המחדל כדי לעמוד בדרישות המותאמות אישית.

במדריך זה, נבחן כמה מקרי שימוש נפוצים לתצורת התצורה של השרת המשובץ של Tomcat דרך ה- application.properties קוֹבֶץ.

2. תצורות Tomcat מוטבעות נפוצות

2.1. כתובת שרת ונמל

התצורה הנפוצה ביותר ייתכן שנרצה לשנות הוא מספר היציאה:

server.port = 80

אם לא נספק את server.port פרמטר שהוא מוגדר ל- 8080 כברירת מחדל.

במקרים מסוימים, נרצה להגדיר כתובת n etwork שאליה השרת אמור להתחייב. במילים אחרות, אנו מגדירים כתובת IP בה השרת שלנו יקשיב:

server.address = my_custom_ip

כברירת מחדל, הערך מוגדר ל- 0.0.0.0 המאפשר חיבור דרך כל כתובות IPv4. הגדרת ערך אחר, למשל, localhost - 127.0.0.1 - יהפוך את השרת לסלקטיבי יותר.

2.2. טיפול בשגיאות

כברירת מחדל, Spring Boot מספק דף אינטרנט עם שגיאות רגילות. דף זה נקרא תווית לבנה. זה מופעל כברירת מחדל, אך אם איננו רוצים להציג מידע שגיאה כלשהו נוכל להשבית אותו:

server.error.whitelabel.enabled = שקר

נתיב ברירת המחדל ל- a תווית לבנה הוא /שְׁגִיאָה. אנו יכולים להתאים אותו על ידי הגדרת ה- server.error.path פָּרָמֶטֶר:

server.error.path = / user-error

אנו יכולים גם להגדיר מאפיינים שיקבעו איזה מידע אודות השגיאה מוצג. לדוגמה, אנו יכולים לכלול את הודעת השגיאה ואת מעקב הערימה:

server.error.include-exception = נכון server.error.include-stacktrace = תמיד

הדרכות שלנו טיפול בהודעות חריגות עבור REST והתאמה אישית של עמוד שגיאת תווית לבנה מסביר יותר על שגיאות טיפול באביב אתחול.

2.3. חיבורי שרת

כאשר אנו פועלים על מיכל משאבים נמוך אנו עשויים לרצות זאת להקטין את עומס המעבד והזיכרון. אחת הדרכים לעשות זאת היא להגביל את מספר הבקשות בו זמנית שניתן לטפל בהן באמצעות היישום שלנו. לעומת זאת, אנו יכולים להגדיל ערך זה בכדי להשתמש במשאבים זמינים רבים יותר כדי להשיג ביצועים טובים יותר.

באביב אתחול, אנו יכולים להגדיר את הכמות המקסימלית של שרשור עובדי Tomcat:

server.tomcat.max-threads = 200

בעת קביעת תצורה של שרת אינטרנט, זה עשוי גם להיות שימושי הגדר את פסק הזמן לחיבור השרת. זה מייצג את משך הזמן המרבי שהשרת יחכה ללקוח שיגיש את בקשתו לאחר ההתחברות לפני סגירת החיבור:

server.connection-timeout = 5s

אנו יכולים גם להגדיר את הגודל המקסימלי של כותרת בקשה:

server.max-http-header-size = 8KB

הגודל המקסימלי של גוף בקשה:

server.tomcat.max-swallow-size = 2MB

או גודל מקסימלי של כל בקשת ההודעה:

server.tomcat.max-http-post-size = 2MB

2.4. SSL

כדי לאפשר תמיכה ב- SSL ביישום Spring Boot שלנו עלינו להגדיר את server.ssl.enabled נכס ל נָכוֹן ולהגדיר פרוטוקול SSL:

server.ssl.enabled = true server.ssl.protocol = TLS

עלינו להגדיר את הסיסמה, הסוג והנתיב לחנות המפתחות המחזיקה את האישור:

server.ssl.key-store-password = my_password server.ssl.key-store-type = keystore_type server.ssl.key-store = keystore-path

ועלינו גם להגדיר את הכינוי שמזהה את המפתח שלנו בחנות המפתחות:

server.ssl.key-alias = tomcat

למידע נוסף על תצורת SSL, בקר ב- HTTPS שלנו באמצעות אישור בחתימה עצמית במאמר Spring Boot.

2.5. יומני גישה לשרת Tomcat

יומני הגישה של Tomcat שימושיים מאוד כאשר מנסים למדוד ספירת התאמות של עמודים, פעילות של פעילויות משתמשים וכן הלאה.

כדי לאפשר יומני גישה, פשוט להגדיר:

server.tomcat.accesslog.enabled = נכון

עלינו להגדיר גם פרמטרים אחרים כגון שם הספריה, הקידומת, הסיומת ופורמט התאריך המצורפים לקבצי יומן:

server.tomcat.accesslog.directory = יומני server.tomcat.accesslog.file-date-format = yyyy-MM-dd server.tomcat.accesslog.prefix = access_log server.tomcat.accesslog.suffix = .log

3. מסקנה

במדריך זה למדנו כמה נפוצים טומקט תצורות שרתים משובצות. לצפייה בתצורות אפשריות נוספות, בקר בדף המסמכים הרשמי של יישום Spring Boot.

כמו תמיד, קוד המקור לדוגמאות אלה זמין ב- GitHub.