-
Notifications
You must be signed in to change notification settings - Fork 2
/
02s-deploying.md.erb
175 lines (111 loc) · 10.7 KB
/
02s-deploying.md.erb
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
---
title: פריסה | Deployment
slug: deploying
date: 0002/01/02
number: 2.5
sidebar: true
photoUrl: http:https://www.flickr.com/photos/monomaniacgarage/10703829133/
photoAuthor: Monomaniacgarage
contents: למדו כיצד לפרוס על Meteor.com.| למדו כיצד לפרוס על Modulus | למדו כיצד לפרוס על שרת משלכם באמצעות Meteor Up.
paragraphs: 46
---
הרבה אנשים אוהבים לעבוד על פרוייקט בחשאי, עד שהוא מושלם. אחרים, רוצים להראות אותו לעולם בהקדם האפשרי.
אם אתם מסוג האנשים שמעדיפים לפתח בסביבה מקומית כרגע, הרגישו חופשיים לדלג מעל הפרק הזה כרגע. עם זאת, אם אתם רוצים להבין כיצד לפרוס / לפרסם את אפליקציית מטאור באופן מקוון עכשיו, הפרק הזה דואג לכל צרכיכם.
בפרק זה נלמד איך לפרוס (deploy) אפליקציית מטאור במספר דרכים שונות. הרגישו בנוח לנסות כל אחת מהדרכים בשלבים שונים של תהליך הפיתוח שלכם, בין אם תעבדו על Microscope או כל אפליקציית מטאור אחרת.
בואו נתחיל!
<% note do %>
### נעים להכיר: SideBars
זהו פרק ***תפריט צד***. פרקים כאלה מאפשרים מבט מעמיק לנושאי מטאור כלליים באופן בלתי תלוי ביתר הספר.
אם תרצו להמשיך בבניית אפליקציית מיקרוסקופ, תוכלו לדלג על פרק זה כרגע, ולחזור אליו מאוחר יותר.
<% end %>
### פריסת אפליקציות במטאור
פריסה (deployment) של אפליקצייה תחת הסאב-דומיין של מטאור (לדוגמא, `http:https://myapp.meteor.com`) היא האופציה הקלה ביותר, והראשונה שננסה.
אופציה זו נוחה על מנת להציג את האפליקציה בשלבים ראשוניים, או על מנת להקים בזריזות סביבת בדיקות.
פריסת האפליקציה על שרתי מטאור קלה מאוד. פתחו את הטרמינל שלכם, נווטו לספרייה בה נמצאת אפליקציית מטאור שלכם, וכתבו
~~~bash
$ meteor deploy myapp.meteor.com
~~~
כמובן שתצטרכו להחליף את "myapp" לשם לבחירתכם, וגם כזה שאינו נמצא כבר בשימוש.
אם זו הפעם הראשונה שבה אתם פורסים אפליקציה, תצטרכו להרשם עם חשבון מטאור. אם הכל עובד כשורה, תוך מספר שניות תוכלו לגשת לאפליקציה שלכם בכתובת `http:https://myapp.meteor.com`.
תוכלו לעיין ב-[תיעוד הרשמי של מטאור](http:https://docs.meteor.com/#deploying) כדי לקבל מידע נוסף כגון גישה למסד הנתונים של האפליקציה שפרסתם, או לגבי קונפיגורציה של דומיין משלכם עבור האפליקציה.
### פריסה על Modulus
[מודולוס modulus.io](https://modulus.io/) הוא אופציה מצוינת לפריסת אפליקציות מבוססות node.js. זהו אחד מספקי התשתית-כשירות (platform-as-a-service) שתומכים באופן רשמי במטאור, וישנם כבר לא מעט אנשים שמריצים אפליקציות מטאור בפרודקשן עליה.
תוכלו ללמוד יותר על מודולוס מקריאת ה[מדריך לפריסת אפליקציות מטאור במודולוס](http:https://help.modulus.io/customer/portal/articles/1647770-using-meteor-with-modulus).
### Meteor Up
למרות שהרבה פתרונות מבוססי ענן צצים כל יום, הרבה מהם מגיעים עם בעיות והגבלות. לפיכך, פריסה על שרת עצמאי נותרת האופציה הטובה ביותר לפרוס אפליקציה בפרודקשן. עם זאת, הדבר לא קל, בוודאי אם רוצים לפרוס לסביבת לקוחות אמיתית.
[מטאור up](https://github.com/arunoda/meteor-up) (או `mup` בקיצור) הוא עוד ניסיון להקל עליכם המפתחים, באמצעות כלי שורת-פקודה שמבצע התקנה ופריסה עבורכם. בואו נראה כיצד לפרוס אפליקציית מטאור באמצעות Meteor Up.
לפני שמתחילים, תצטרכו שרת לדחוף את האפליקציה אליו. אנו ממליצים על [Digital Ocean](http:https://digitalocean.com), שתוכניות הפריסה שלו מתחילות ב-5$ לחודש, או על[AWS](http:https://aws.amazon.com/) שמאפשרת לפרוס שרת בסיסי בחינם, אבל מהר מאוד דורשת תשלום, אם כי הדבר מאפשר לשחק עם Meteor Up בשלב זה.
לא משנה באיזה שרת תבחרו, תצטרכו את כתובת ה-IP של השרת שלכם, את שם המשתמש שלכם (בדרך כלל: root) ואת הסיסמא. שמרו אותם במקום בטוח, כי תיכף נצטרך אותם!
### איתחול Meteor Up
על מנת להתחיל, נצטרך להתקין את מטאור באמצעות `npm` כך:
~~~bash
$ npm install -g mup
~~~
עתה ניצור מחיצה נפרדת שתכיל את הגדרות Meteor Up עבור הפריסה הספציפית הזו. אנו משתמשים במחיצה נפרדת בשל 2 סיבות עיקרוניות:
קודם כל, עדיף לשמור פרטי התקשרות פרטיים מחוץ למאגר ה-git שלכם, בייחוד אם אתם עובדים על בסיס קוד פומבי.
שנית, על ידי שימוש בספריות נפרדות, תוכלו לנהל מספר קונפיגורציות של meteor up במקביל. כך למשל תוכלו לפרוס לסביבת בדיקות ולסביבת פרודקשן (לקוחות) למשל.
אם כך, בואו ניצור את המחיצה ונאתחל אותה לפרוייקט Meteor up חדש:
~~~bash
$ mkdir ~/microscope-deploy
$ cd ~/microscope-deploy
$ mup init
~~~
<% note do %>
### שיתוף באמצעות Dropbox
דרך מצוינת להבטיח שאתם וכל הצוות שלכם עובדים באותה קונפיגורציה, היא פשוט לשתף את המחציה שמכילה את הגדרות Meteor Up באמצעות דרופבוקס (Dropbox) או שירות דומה אחר.
<% end %>
### Meteor Up Configuration
כאשר מתחילים פרוייקט חדש, Meteor Up יצור עבורכם שני קבצים:`mup.json` ו-`settings.json`.
`mup.json` יכיל את כל העדפות הפריסה שלכם, ולעומתו `settings.json יכיל את כל נתוני האפליקציה שלכם (Oauto token, analytics token וכו').
הצעד הבא שלכם יהיה לשנות את `mup.json` בהתאם להעדפותיכם. הנה דוגמה לקובץ `mup.json` ברירת מחדל שנוצא באמצעות `mup init`, וכל שאתם צריכים הוא להשלים את החסר:
~~~js
{
//server authentication info
"servers": [{
"host": "hostname",
"username": "root",
"password": "password"
//or pem file (ssh based authentication)
//"pem": "~/.ssh/id_rsa"
}],
//install MongoDB in the server
"setupMongo": true,
//location of app (local directory)
"app": "/path/to/the/app",
//configure environmental
"env": {
"ROOT_URL": "http:https://supersite.com"
}
}
~~~
<%= caption "mup.json" %>
בואו נביט בהעדפות הללו צעד-צעד:
**אותנטיקציה עם השרת: Server Authentication**
תבחינו ש-Meteor Up תומך באותנטיקציה (אימות זהות) מבוססת סיסמא ומבוססת מפתח פרטי (PEM), כך שניתו להשתמש בכלי באמצעות כמעט כל שירות ענן בנמצא.
**הערה חשובה:**
אם תבחרו להשתמש באותנטיקציה מבוססת סיסמא, אנא ודאו שהתקנתם`sshpass` כצעד ראשון. השתמשו ([במדריך הזה](https://gist.github.com/arunoda/7790979))
**הגדרת מסד הנתונים MongoDB**
הצעד הבא הוא להגדיר את מסד הנתונים שלכם, מסוג MongoDB, עבור האפליקציה. אנו ממליצים על [Compose](https://www.compose.io) או כל ספק MongoDB, כיוון שהם מספקים שירות מקצועי וכלי ניהול טובים.
אם החלטתם להשתמש ב-Compose, סמנו את `setupMongo` כ-`false` והוסיפו משתנה סביבה `MONGO_URL` בקובץ `mup.json` בחלק ה-`env` שלו. אם החלטתם לארח את MongoDV באמצעות Meteor Up,
כל שעליכם לעשות הוא לסמן את `setupMongo` כ- `true`, ומטאור יעשה את השאר.
**נתיב אפליקציית מטאור**
כיוון ש-Meteor Up שלנו "חי" במחיצה אחרת, נצטרך להפנות את מטאור למחיצה בה נמצאת האפליקציה שלנו באמצעות ערך ה-`app`. פשוט כתבו בערך זה את הנתיב המלא לאפליקציה, אותו ניתן לקבל כאשר משתמשים בפקודה `pwd` כאשר נמצאים במחיצת האפליקציה בטרמינל.
**משתני סביבה**
תוכלו לציין את כל משתני הסביבה שלכם (כגון `ROOT_URL`, `MAIL_URL`, `MONGO_URL` וכדומה) בתוך חלק ה- `env` שבקובץ.
### הקמה ופריסה
לפני הפריסה, נצטרך להכין את השרת כך שהוא יכול לארח אפליקציית מטאור. הקסם ב-Meteor Up מכניס את התהליך המורכב הזה לפקודה אחת ויחידה!
~~~bash
$ mup setup
~~~
פקודה זו תיקח מספר דקות לרוץ, בהתאם לאיכות השרת ולחיבוריות הרשת. לאחר שההכנה לפריסה הצליחה, נוכל סוף סוף לפרוס את האפליקציה שלנו באמצעות:
~~~bash
$ mup deploy
~~~
פקודה זו תארוז את אפליקציית מטאור שלנו, ותפרוס אותה לשרת שהקמנו.
### Displaying Logs
הדפסות יומן (logs) הינן חשובות מאוד ו-Meteor Up מאפשר דרך קלה מאוד לעקוב אחריהן, שמדמה את הפקודה `tail -f`. פשוט כתבו:
~~~bash
$ mup logs -f
~~~
תיאור זה מהווה סקירה לגבי יכולות הכלי Meteor Up. לעוד מידע, אנו מציעים שתבקרו ב-[Meteor Up's GitHub repository](https://github.com/arunoda/meteor-up).
שלוש דרכים אלה לפרוס אפליקציות מטאור אמורות להספיק לרוב תרחישי השימוש. כמובן שאנו מודעים לכך שחלקכם תרצו להיות יותר בשליטה ולבנות שרת לאפליקציית מטאור מאפס. זה נושא ליום אחר... ואולי לספר אחר!