שימוש ב-phpMyAdmin עם Cloud SQL בסביבה רגילה של App Engine

איך מתקינים את phpMyAdmin בסביבת App Engine סטנדרטית אפשר להשתמש ב-phpMyAdmin כדי לנהל את Cloud SQL דרך האינטרנט.

המדריך הזה יעזור לכם אם:

• הפעלת אפליקציות ב-App Engine.
• משתמשים ב-Cloud SQL כמסד הנתונים.
• אתם משתמשים ב-phpMyAdmin כממשק ל-MySQL או שאתם מעדיפים ממשק אינטרנט לניהול מסד נתונים.

הערה: המדריך הזה רלוונטי רק ל-MySQL מגרסה 5.7 ומטה.

אם אתם משתמשים ב-Compute Engine, כדאי לכם להשתמש באחד ממוצרי או מחסני הפיתוח שזמינים דרך Click to Deploy. פריסות של מחסניות שכוללות MySQL, כמו LAMP ו-LEMP, או מוצרים כמו Drupal, מספקות אפשרות להתקין את phpMyAdmin כחלק מהפריסה.

מטרות

• פריסת phpMyAdmin בסביבה הרגילה של App Engine.

עלויות

במדריך הזה נעשה שימוש ברכיבים של Cloud Platform שחלים עליהם חיובים, כולל:

• App Engine
• Cloud SQL

אפשר להשתמש במחשבון עלויות כדי ליצור הערכת עלויות בהתאם לשימוש החזוי.

משתמשים חדשים ב-Cloud Platform עשויים להיות זכאים לתקופת ניסיון בחינם.

לפני שמתחילים

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

מתקינים את ה-CLI של gcloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

מתקינים את ה-CLI של gcloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

כדי לאתחל את ה-CLI של gcloud, הריצו את הפקודה הבאה:

gcloud init

1. יוצרים מכונה של Cloud SQL מהדור השני.
2. (אופציונלי) פורסים אפליקציית App Engine שמשתמשת במופע Cloud SQL או בוחרים אפליקציה קיימת.

   לדוגמה, יוצרים ומפעילים את דוגמת ספר האורחים. אפשר לפרוס את phpMyAdmin לבד, אבל סביר להניח שתרצו להשתמש בו עם אפליקציית App Engine בתרחיש שלכם.

הורדת קוד המקור של phpMyAdmin

תפרסו את phpMyAdmin כשירות של אפליקציית App Engine, ולכן תצטרכו להוריד את קוד המקור של phpMyAdmin. איך לעשות את זה?

1. בטרמינל של Cloud Shell, מזינים את הפקודה הבאה כדי להוריד את קוד המקור של phpMyAdmin בגרסה 4.9.5:

   wget https://files.phpmyadmin.net/phpMyAdmin/4.9.5/phpMyAdmin-4.9.5-all-languages.tar.gz
   

   כדי להשתמש בגרסה אחרת של phpMyAdmin, אפשר להיעזר בקישורים לגרסאות הזמינות בדף ההורדות של phpMyAdmin.

2. יוצרים ספרייה חדשה. הקבצים יחולצו לספרייה הזו.

   mkdir phpMyAdmin
   

3. מחלקים את הקבצים מהארכיון לספרייה החדשה.

   tar -xzvf phpMyAdmin-4.9.5-all-languages.tar.gz -C phpMyAdmin --strip-components=1
   

הכנת הקבצים לפריסה

כדי לפרוס את phpMyAdmin, צריך ליצור שלושה קבצים: app.yaml, שמכיל את פרטי ההגדרה של App Engine;‏ config.inc.php, שמכיל את פרטי ההגדרה של phpMyAdmin; ו-php.ini, שמכיל הגדרה ספציפית לאפליקציה עבור PHP.

יצירת app.yaml

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

1. בספרייה שיצרתם, שנקראת phpMyAdmin, יוצרים קובץ חדש בשם app.yaml.

   cd phpMyAdmin
   touch app.yaml
   

2. בעורך המועדף שלכם, מדביקים את הטקסט הבא ב-app.yaml.

   service: phpmyadmin
   runtime: php55
   api_version: 1
   
   handlers:
   
   - url: /(.+\.(ico|jpg|png|gif))$
     static_files: \1
     upload: (.+\.(ico|jpg|png|gif))$
     application_readable: true
   
   - url: /(.+\.(htm|html|css|js))$
     static_files: \1
     upload: (.+\.(htm|html|css|js))$
     application_readable: true
   
   - url: /(.+\.php)$
     script: \1
     login: admin
   
   - url: /.*
     script: index.php
     login: admin
   

3. אם אתם פורסים את phpMyAdmin בתור האפליקציה הראשונה והיחידה ב-App Engine, צריך לשנות את הערך של service מ-phpmyadmin ל-default.

   בדרך כלל, פורסים את phpMyAdmin כשירות של אפליקציה קיימת ומזינים שם לשירות. עם זאת, אם עדיין לא פרסתם אפליקציה, אתם נדרשים להשתמש בשם השירות 'default'. זה בסדר למטרות המדריך הזה אם אתם מנסים את phpMyAdmin ב-App Engine.

   המדריך הזה מתאים רק לסביבה הרגילה של App Engine.

4. שומרים את הקובץ.

יצירת config.inc.php

כדי ליצור את קובץ ההגדרות של phpMyAdmin:

1. יוצרים קובץ חדש בשם config.inc.php.

   touch config.inc.php
   

2. בעורך המועדף שלכם, מדביקים את הטקסט הבא ב-config.inc.php.

   <?php
   /**
    * Copyright 2016 Google Inc.
    *
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *     http://www.apache.org/licenses/LICENSE-2.0
    *
    * Unless required by applicable law or agreed to in writing, software
    * distributed under the License is distributed on an "AS IS" BASIS,
    * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    * See the License for the specific language governing permissions and
    * limitations under the License.
    */
   /*
    * This is needed for cookie based authentication to encrypt password in
    * cookie
    * http://www.question-defense.com/tools/phpmyadmin-blowfish-secret-generator
    */
   $cfg['blowfish_secret'] = '{{your_secret}}'; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
   
   /*
    * Servers configuration
    */
   $i = 0;
   
   // Change this to use the project and instance that you've created.
   $host = '/cloudsql/{{your_connection_string}}';
   $type = 'socket';
   
   /*
   * First server
   */
   $i++;
   /* Authentication type */
   $cfg['Servers'][$i]['auth_type'] = 'cookie';
   /* Server parameters */
   $cfg['Servers'][$i]['socket'] = $host;
   $cfg['Servers'][$i]['connect_type'] = $type;
   $cfg['Servers'][$i]['compress'] = false;
   /* Select mysql if your server does not have mysqli */
   $cfg['Servers'][$i]['extension'] = 'mysqli';
   $cfg['Servers'][$i]['AllowNoPassword'] = true;
   /*
    * End of servers configuration
    */
   
   /*
    * Directories for saving/loading files from server
    */
   $cfg['UploadDir'] = '';
   $cfg['SaveDir'] = '';
   
   /*
   * Other settings
   */
   $cfg['PmaNoRelation_DisableWarning'] = true;
   $cfg['ExecTimeLimit'] = 60;
   $cfg['CheckConfigurationPermissions'] = false;
   

3. פותחים את Google Cloud Shell ומריצים את הפקודה הבאה כדי לקבל מחרוזת אקראית בשביל Blowfish:

   php -r "echo password_hash(uniqid(), PASSWORD_BCRYPT).PHP_EOL;"
   

4. מדביקים את הסוד החדש במקום {{your_secret}} ב-config.inc.php.

5. נכנסים אל דף המכונות של Cloud SQL במסוף Google Cloud .

6. לוחצים על המכונה של Cloud SQL כדי להציג את דף הפרטים שלה.

7. מחליפים את הערך של {{your_connection_string}} (בתוך המשתנה $host) במאפיין Instance connection name (שם החיבור של המופע).

8. שומרים את הקובץ.

יצירת php.ini

בקוד שלו, phpMyAdmin משתמש בפונקציות שמושבתות כברירת מחדל ב-App Engine. כדי להוסיף קובץ php.ini כדי שמערכת App Engine תפעיל שוב את הפונקציות:

1. בספרייה phpMyAdmin, יוצרים את הקובץ.

   touch php.ini
   

2. עורכים את הקובץ ומוסיפים את השורה הבאה:

   google_app_engine.enable_functions = "php_uname, getmypid"
   

3. שומרים את הקובץ.

פריסת האפליקציה

משתמשים בפקודות הבאות כדי לפרוס את האפליקציה ב-App Engine.

1. בודקים אם יש עדכונים לרכיבי gcloud.

   gcloud components update
   

2. מריצים את הפקודה הבאה מתוך התיקייה phpMyAdmin שבה נמצא הקובץ app.yaml כדי לפרוס את האפליקציה:

   gcloud app deploy
   

   הפקודה הזו פורסת את האפליקציה בשירות phpMyAdmin, כפי שצוין בקובץ app.yaml. פריסה לשירות נפרד עוזרת להבטיח ש-phpMyAdmin יפעל באותו מרכז נתונים כמו האפליקציה הראשית, וכך לשפר את הביצועים. מידע נוסף על פריסת האפליקציה משורת הפקודה זמין במאמר בנושא פריסת אפליקציית PHP.

התחברות ל-phpMyAdmin

עכשיו אפשר להתחבר ל-phpMyAdmin.

1. בדפדפן האינטרנט, מזינים את כתובת ה-URL של phpMyAdmin כדי לפתוח את דף הפתיחה, ומשנים את כתובת ה-URL כך שתכלול את מזהה האפליקציה.

       https://phpmyadmin-dot-[YOUR_APP_ID].appspot.com
   

2. בשדה שם משתמש, מזינים root.

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

4. לוחצים על המשך.

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

פתרון בעיות

‫App Engine משתמש בשרת proxy ל-Cloud SQL Auth כדי להתחבר למכונות Cloud SQL מהדור השני. מידע נוסף על האופן שבו שרת ה-Proxy ל-Cloud SQL Auth פועל זמין במאמר מידע על שרת ה-Proxy ל-Cloud SQL Auth.

היומנים של App Engine במסוףGoogle Cloud יכולים לספק מידע על שגיאות ב-App Engine.

הסרת המשאבים

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

מחיקת הפרויקט

הדרך הקלה ביותר לבטל את החיוב היא למחוק את הפרויקט שיצרתם בשביל המדריך הזה.

כדי למחוק את הפרויקט:

זהירות: כשמוחקים פרויקט:

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

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

מחיקת מכונות

כדי למחוק מכונה של Cloud SQL:

1. נכנסים לדף Instances במסוף Google Cloud .

   כניסה לדף Instances

2. לוחצים על השם של מכונת ה-SQL שרוצים למחוק.
3. כדי למחוק את המכונה, לוחצים על Delete ופועלים לפי ההוראות.

המאמרים הבאים

• מידע נוסף על phpMyAdmin
• כדאי להעמיק את הקריאה ולהכיר דוגמאות לארכיטקטורות, תרשימים ושיטות מומלצות בנושאי Google Cloud. כל אלה זמינים במרכז הארכיטקטורה של Cloud.