diff --git a/source/content/add-site-dashboard.md b/source/content/add-site-dashboard.md deleted file mode 100644 index ba3521fe27..0000000000 --- a/source/content/add-site-dashboard.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Create a New CMS Site -description: Create a WordPress or Drupal site using the Dashboard. -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [create] -cms: [wordpress, drupal] -audience: [developers] -product: [--] -integration: [--] -tags: [--] -showtoc: true ---- - - Pantheon CMS site contains three components: code, files, and a database containing the content and configurations of your Content Management System (CMS). When you create a site, you are creating each of these components in the Dev environment. Then, when you are ready, you will create your Test and Live environments. - - - -## Create the Dev Environment - -To create a CMS site: - - - - - -### Install the CMS - - - -You have successfully finished adding a site in its Dev environment. Click **Visit Dev Site** to view your site. - -## Create the Test environment - - - -You have successfully finished adding a site in its Test environment. Click **Visit Test Site** to view your site. - -## Create the Live environment - -After you [purchase a plan](/guides/getstarted/purchase), you can deploy your site live. But first, you have to create the Live environment. - - - -When you complete this step, your site will be live for anyone to see, at the Pantheon URL. For detailed information about launching your site, refer to our [Launch Essentials](/guides/launch/) guide. - - - - - -You have successfully finished adding a site in its Live environment. Click **Visit Live Site** to view your site. - -At this point, you have a live site with a Pantheon URL, like `http://my-site.pantheonsite.io/`. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our [Domains on Pantheon Guide](/guides/domains) for more information. diff --git a/source/content/add-site.md b/source/content/add-site.md deleted file mode 100644 index 3751facf36..0000000000 --- a/source/content/add-site.md +++ /dev/null @@ -1,106 +0,0 @@ ---- -title: Adding a Site to Pantheon -description: Create or migrate a site on Pantheon. -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [migrate, create] -cms: [drupal, wordpress] -audience: [agency, development] -product: [--] -integration: [--] -showtoc: false -reviewed: 2023-04-06 ---- - -There are many ways you can add a site to Pantheon. To help you choose the best method, answer the questions below. - - - -This list does not include scenarios for decoupled architecture. For those, see [Front-End Sites on Pantheon](/guides/decoupled). - - - -## Find Your Path - -**How do you want to add a site?** You have the following options: -- *Create* from scratch -- Create a site from a *Custom Upstream* -- *Migrate* a site that's hosted elsewhere - - - - - -**Would you like to create your site using the dashboard (which will guide you through the process), or use the command line?** - -- [I want to use the Dashboard](/add-site-dashboard) -- I want to use the command line, and my CMS is: - - [Drupal](/terminus-drupal-site-management) - - [WordPress](/guides/create-wp-site) - - - - - -If you are a part of a Professional team that has [Custom Upstreams](/guides/custom-upstream), you can build a site from an existing Upstream. - -- Refer to [Create a Site Using a Custom Upstream](/add-site-custom-upstream) - - - - - -**Is your site archive greater than 500MB, or does it only exist on your local machine?** - -- If so, [manually migrate your site to Pantheon](/migrate-manual) - -- If not... - - **Are you coming from one of the following platforms?** - - If so, read our guide for migrating from the platform: - - - [Acquia](/guides/acquia) - - [Kinsta](/guides/kinsta) - - [Pagely](/guides/pagely) - - [Platform.sh](/guides/platformsh) - - [WordPress VIP](/guides/wordpressvip) - - [WP Engine](/guides/wpengine) - - - If not... - - **Which CMS are you using?** - - - - **Do you want to upgrade your Drupal version during migration, or are you using Drupal version 9 or higher?** - - - [No, remain at my current version](/guides/guided) - - - [No, I am using Drupal version 8 or lower](/guides/drupal-unhosted) - - - Yes, upgrade my site to the latest version of Drupal: - - [My site is Composer-managed, *and* I'm using Drush](/guides/drush/drush-import) - - [My site is Composer-managed, and I'm *not* using Drush](/guides/drupal-unhosted-composer) - - [My site is *not* Composer-managed](/guides/drupal-unhosted) - - - - - - [Use our guided migration](/guides/guided), unless you have one of the following scenarios: - - - **To use a Custom Upstream**, [use the Pantheon Migrations plugin with a custom WordPress upstream](https://wordpress.org/plugins/bv-pantheon-migration/#description) - - - **If you are using Multisite**, use [Migrate a WordPress Multisite](/migrate-wordpress-multisite). - - - **To avoid installing a plugin**, use [Manually Migrate Your Site to Pantheon](/migrate-manual). - - - - - - - - - diff --git a/source/content/autopilot.md b/source/content/autopilot.md deleted file mode 100644 index 91fb0dc17e..0000000000 --- a/source/content/autopilot.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Autopilot Product Overview -description: Always keep your sites up to date. -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [overview] -cms: [--] -audience: [development, sysadmin] -product: [dashboard] -integration: [--] -tags: [--] -showtoc: false ---- - - - - - -Pantheon's Autopilot: - -- Automatically detects when new WordPress or Drupal updates are available -- Performs the updates in an isolated [Multidev](/guides/multidev) environment -- Tests the updates with automated visual regression testing (VRT) -- Optionally deploys the updates - -![Autopilot Dashboard](../images/autopilot/autopilot-sites-overview.png) - - - - - -- Schedule updates Monthly, Weekly or Daily -- Update Core CMS, themes and extensions -- Hands-off visual regression testing (VRT) -- Pre-configured workflows -- Triggered notifications -- Activity reporting - -*Autopilot Setup Wizard* - -![Autopilot Setup Wizard](../images/autopilot/autopilot-setup-configuration.png) - -*Reviewing Test Results* - -![Reviewing Test Results](../images/autopilot/autopilot-review-test-results.png) - -*View Recent Activity* - -![View Recent Activity](../images/autopilot/autopilot-site-recent-activity.png) - - - - - -- Gold, Platinum or Diamond account. -- WordPress or Drupal site -- If you're using Drupal, a [compatible version of Drush or Integrated Composer](/guides/autopilot/autopilot-faq/#what-versions-of-drupal-are-supported-by-autopilot) - - - - - -## Documentation - -- [Autopilot Guide](/guides/autopilot) -- [Autopilot and Custom Upstreams](/guides/autopilot-custom-upstream) - -## Learning - -- [Autopilot Overview](https://learning.pantheon.io/autopilot-quick-start) -- [Is Autopilot Right for My Website?](https://learning.pantheon.io/is-autopilot-right-for-my-website-quick-lesson) - -## Support - -- [Account holders](https://dashboard.pantheon.io/workspace/support) - - - - diff --git a/source/content/crisis-response-upstream.md b/source/content/crisis-response-upstream.md index a600d16768..cc5ab4e407 100644 --- a/source/content/crisis-response-upstream.md +++ b/source/content/crisis-response-upstream.md @@ -74,7 +74,7 @@ These plugins were selected to improve the content creation and moderation proce If not, use your email address for the username and click on **Forgot Password**. Be sure to set a strong password. -1. After the site is configured correctly in the Dev environment, you can [create the Test and Live environments](/add-site-dashboard#create-the-test-environment), copying your code and the initial database to each. +1. After the site is configured correctly in the Dev environment, you can [create the Test and Live environments](/guides/getstarted/addsite/#create-the-test-environment), copying your code and the initial database to each. 1. If you update your site code or add a new plugin, you can use the [Pantheon WebOps workflow](/pantheon-workflow). On your site's Pantheon dashboard, once changes are [committed](/guides/sftp/sftp-development), the Deploys panel in the Test environment will prompt you to deploy the changes to the Test environment. diff --git a/source/content/custom-upstreams.md b/source/content/custom-upstreams.md deleted file mode 100644 index 5128b9673b..0000000000 --- a/source/content/custom-upstreams.md +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Custom Upstreams -description: Centralized Management for Your Sites -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [overview] -cms: [--] -audience: [development, sysadmin] -product: [custom-upstreams] -integration: [--] -tags: [--] -showtoc: false ---- - - - - - -As site numbers grow and demands become more diverse, the choice between enforcing standards and allowing individual sites flexibility to meet unique goals can become a real struggle. Custom Upstreams allow control over site standards, while still allowing customization when needed, all without introducing any single points of failure. - -Custom Upstreams act as a scaffold for new sites, allowing developers and site owners of any skill level to kickoff projects at warp speed. - -Instead of repeating the same technical work on each individual site, you can build and maintain a common user interface with unified branding and functionality once, in a single source. - -![Custom Upstreams](../images/upstreams-foundations4.svg) - - - - - - -* Quickly build new sites per your predefined standards -* Standardize design functionality across many sites -* Simplify the updates of multiple sites - -*Manage Custom Upstreams from the Dashboard* - -![Manage Custom Upstreams from the Dashboard](../images/manage-custom-upstreams.png) - -*Add a Custom Upstream* - -![Add a Custom Upstream](../images/add-custom-upstream.png) - - - - - -* Gold, Platinum or Diamond Account Tier -* Create or manage upstreams: Administrator or Owner -* Change or deploy upstream: Administrator, Team Member, Developer - - - - - - -## Documentation - -* [Custom Upstreams Guide](https://docs.pantheon.io/guides/custom-upstream) - -## Learning - -* [Custom Upstreams Training](https://learning.pantheon.io/page/catalog#topic_custom-upstreams) - -## Support - -* [Users with a Pantheon account](https://dashboard.pantheon.io/workspace/support) - - - - diff --git a/source/content/customer-scheduled-cron-jobs.md b/source/content/customer-scheduled-cron-jobs.md index ce25bce560..e8a52c33fe 100644 --- a/source/content/customer-scheduled-cron-jobs.md +++ b/source/content/customer-scheduled-cron-jobs.md @@ -28,7 +28,7 @@ While this feature is in Early Access, Pantheon's development team releases new -The [Terminus](/terminus-overview) Scheduled Jobs Plugin allows customers to schedule and automate specific cron jobs according to their requirements. You can specify the desired frequency (e.g., daily, weekly, monthly, hourly), and the actions to be performed. The system then executes the scheduled jobs automatically based on the provided instructions. +The [Terminus](/terminus) Scheduled Jobs Plugin allows customers to schedule and automate specific cron jobs according to their requirements. You can specify the desired frequency (e.g., daily, weekly, monthly, hourly), and the actions to be performed. The system then executes the scheduled jobs automatically based on the provided instructions. ## Requirements diff --git a/source/content/cygwin-windows.md b/source/content/cygwin-windows.md deleted file mode 100644 index a31a80a5e0..0000000000 --- a/source/content/cygwin-windows.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Install Cygwin on Windows -description: Learn how to install and configure Cygwin on Windows computers for Pantheon sites. -tags: [local, ssh] -reviewed: "2020-02-05" -contenttype: [doc] -innav: [true] -categories: [cli] -cms: [--] -audience: [development] -product: [--] -integration: [--] ---- - - - -This guide is unmaintained. For Windows 10 users, we recommend using the [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install-win10) to create a Linux environment on Windows. Once you've installed the Subsystem, follow the instructions in the [Terminus Guide](/terminus/install/). - - - -If you do not have access to a Mac or Linux environment, you can install [Cygwin](https://cygwin.com/) to perform tasks typically not possible in Windows, such as: - -* Installing and using [Terminus, the Pantheon command line interface (CLI)](https://github.com/pantheon-systems/cli) - -## Install Cygwin - -1. Download the [Cygwin](https://cygwin.com/install.html) installer and run `setup.exe`. - -1. Click **Next** through the defaults and select **mirror** for downloading packages. - -1. Search for each package, open the appropriate category (Net or PHP), and click **Skip** next to each package to select it for installation. Required packages: `curl`, `openssh`, `openssl` (Net), `php`, `php-curl`, `php-json`, `php-phar` (PHP) - - ![Select openSSL package](../images/cygwin-select-packages.png) - -1. Complete the set up. Repeat this process when updating Cygwin or adding more packages. diff --git a/source/content/dns-providers/google.md b/source/content/dns-providers/google.md deleted file mode 100644 index 7dd40eee95..0000000000 --- a/source/content/dns-providers/google.md +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: Google Domain Configuration -provider: Google -description: Learn how to point your Google domain to a Pantheon site. -tags: [domains] -permalink: docs/:basename -editpath: dns-providers/google.md/ -contenttype: [doc] -innav: [true] -categories: [domains] -cms: [--] -audience: [--] -product: [--] -integration: [google] ---- -## Before You Begin -Be sure that you have a: - -- Registered domain name using Google Domains to host DNS -- [Paid Pantheon plan](/guides/launch/plans) -- [Domain connected](/guides/launch/domains) to the target Pantheon environment (typically Live) - -## Locate Pantheon's DNS Values -Identify DNS values to point your domain to Pantheon: - -1. Navigate to the [Site Dashboard](/guides/account-mgmt/workspace-sites-teams/sites#site-dashboard) and select the target environment (typically Live) then click ** Domains / HTTPS**. -2. Click the **Details** button next to your domain. - -Keep this page open and login to your [Google Domains account](https://domains.google.com/registrar) in a new tab before you continue. - -## Configure DNS Records on Google Domains - -### A Record -1. Select the **Configure DNS** icon within the Google Domains interface: - - ![Google configure dns](../../images/google-config-dns.png) - -2. Scroll to the **Custom resource records** section. -3. Enter **@** in the **Host** field and provide the A record value provided by Pantheon in the **IPv4** field. -4. Set desired Time to Live (TTL). - - - - #### Time to Live (TTL) - - The TTL dictates the lifespan of a DNS record; a shorter time means less time to wait until the changes go into effect. TTLs are always set in seconds with a few common ones being 86400 (24 hours), 43200 (12 hours), and 3600 (1 hour). - - When you make a change to the TTL of an existing record, you need to wait for the old TTL time to pass - that is, if it had been set to 86400, you would need to wait a full 24 hours for the new setting to begin propagating everywhere. - - - -5. Click **Add** to create the record. - -![Google configure ipv4](../../images/google-a-record.png) - - -### AAAA Records - -1. Within the same section (**Custom resource records**), change the record type from **A** to **AAAA**. -2. Enter **@** in the **Host** field and provide the first AAAA record value provided by Pantheon in the **IPv6 address** field. -3. Click the **+** icon to the right of the IPv6 field then enter the second AAAA record provided by Pantheon in the **IPv6 address** field. -4. Set desired Time to Live (TTL), then click **Add** to create the record. - -![Google configure ipv6](../../images/google-aaaa.png) - - -### Subdomains -Create one A record and 2 AAAA records for the given subdomain (e.g., `www.example.com`): - -1. Within the same section (**Custom resource records**), select the record type **A**. -2. Enter `www` in the **Host** field and enter the A record value provided by Pantheon (e.g. `23.185.0.2`) in the **IPv4** field. -3. Set desired Time to Live (TTL), then click **Add** to create the record. -4. Repeat steps 1-3 for the two AAAA records. - - -## Next Steps - -* [Launch Essentials: Domains & HTTPS](/guides/launch/domains) - -* [Launch Essentials: Redirect to a Primary Domain](/guides/launch/redirects) diff --git a/source/content/drupal-10.md b/source/content/drupal-10.md deleted file mode 100644 index 31eca44d67..0000000000 --- a/source/content/drupal-10.md +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Drupal 10 on Pantheon -description: Your hub for all things Drupal 10. -tags: [code, launch, migrate, site, updates] -contributors: [wordsmither] -reviewed: "2022-10-18" -contenttype: [doc] -innav: [true] -categories: [create, cms] -cms: [drupal10] -audience: [development] -product: [composer] -integration: [--] ---- - -Drupal 10 is now available on the Pantheon platform. This page will be updated frequently with the latest information and instructions for Drupal 10 on Pantheon. - -## Current Status of Drupal 10 at Pantheon - -| Scenario | Status | Documentation | -|---------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|--------------------------------------------------------------------------------------| -| Create a Drupal 10 site on Pantheon | Available | [Create a Drupal 10 Site](/drupal-10#create-a-drupal-10-site) | -| Upgrade a Drupal 9 site to Drupal 10 manually | Available | [Upgrade from Drupal 9 to Drupal 10](/drupal-10#update-a-drupal-9-site-to-drupal-10) | -| Upgrade a Drupal 9 site to Drupal 10 using the [Terminus Conversion Tools plugin](https://github.com/pantheon-systems/terminus-conversion-tools-plugin) | Early Access | Use the following command: `terminus conversion:upgrade-d10` | - -## Update a Drupal 9 Site to Drupal 10 - -1. Confirm that the site uses PHP 8.1 or higher: - - Go to the [Site Dashboard](/guides/account-mgmt/workspace-sites-teams/sites#site-dashboard) and click **Settings**, and then click **PHP version**. The PHP 8.1+ update will show as available to install if you are not already on it. - - If you are not on PHP 8.1 and you don't see the update, refer to [Upgrade PHP Versions](/guides/php/php-versions) for instructions on updating your PHP version. - -1. Run [Drupal's Upgrade Status](https://www.drupal.org/project/upgrade_status). - -1. Use [Composer to update](/upgrade-drupal-with-ic-to-latest#set-drupal-core-version) to Drupal 10. Refer to the [Drupal release-specific documentation](https://www.drupal.org/project/drupal/releases) for more information. - - Composer will prompt you to add `phpstan/extension-installer` to your `allow-plugins` config if you haven't done so already. - -## Create a Drupal 10 Site - -This process requires [Composer](https://getcomposer.org/doc/01-basic-usage.md) version 2.2 and uses Pantheon's current [PHP version](/guides/php#supported-php-versions). - -1. Create a new Drupal site using the ["Drupal with Composer" CMS/Start State](/add-site/) documentation. - -1. [Clone the site](/guides/git/git-config#clone-your-site-codebase) locally with Git. - - - The cloned site contains a pre-configured `composer.json` file. No additional configuration is needed for the site to work on Pantheon. - -1. Review the documentation to [install and configure Git](/guides/git/git-config) correctly before you begin developing your site on Pantheon. - -## FAQ - -### Will my Drupal 9 site be forced to upgrade to Drupal 10? - -No, Drupal 9 sites can continue to use Drupal 9. - -### How do I upgrade my existing site from Drupal 9 to Drupal 10? - -Refer to [Upgrade from Drupal 9 to Drupal 10](/drupal-10#update-a-drupal-9-site-to-drupal-10). - -### Where do I go with questions? - -Ask questions in our Slack [#drupal channel](https://pantheon-community.slack.com/archives/CTA1621KK). - -## More Resources - -- [Drupal on Pantheon](/drupal) -- [Using Drupal with Pantheon](/develop-drupal) diff --git a/source/content/drupal-composer-managed.md b/source/content/drupal-composer-managed.md deleted file mode 100644 index b89a2ef355..0000000000 --- a/source/content/drupal-composer-managed.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -title: Pantheon Drupal (Composer Managed) Upstream -description: Release notes and customizations to the Pantheon Drupal (Composer Managed) Upstream -tags: [code, site, upstreams] -showtoc: true -reviewed: "2023-02-23" -contenttype: [doc] -innav: [true] -categories: [custom-upstreams] -cms: [drupal] -audience: [agency, business, development] -product: [custom-upstreams] -integration: [--] ---- - -This document provides additional context to platform-specific changes in Pantheon's Composer-managed Drupal upstream. - -## Latest Release - -### 2023-02-23 - -This release prepares sites on the Drupal (Composer Managed) upstream for Drupal 10. The specific changes made in this release include: - -- The `upstream-require` command was moved to a new project, `pantheon-systems/upstream-management` -- A `post-update` hook is added to the site's top-level `composer.json` file; this hook is for potential future use, and does not do anything at present. If you remove it, Pantheon will add it again. The hook's purpose is to allow us to manage potential future changes that must be applied to sites using this upstream. -- The `enable-patching` flag is added to the site's top-level `composer.json` file. Patches from dependencies may not be applied if this option is missing, so we are including it to avoid confusion. The most recent version of `cweagans/composer-patches` still requires this flag, but it is slated to be removed in a future release. If you do not want this flag enabled in your project’s `composer.json` file, you may remove it, and it will not be replaced. -- The `phpstan/extension-installer` Composer plugin is enabled, if it isn't already, to reduce friction with future upgrades to Drupal 10, which includes this extension. - -These changes have minimal impact on existing sites today, and are primarily intended to keep the Drupal (Composer Managed) upstream in a state where it is easy for Pantheon to maintain the new Drupal 10 "start state" upstream. Refer to [pantheon-upstreams/drupal-10-composer-managed on GitHub](https://github.com/pantheon-upstreams/drupal-10-composer-managed) for more information. - -## Previous Releases - -### 2022-12-13 - -Update to PHP 8.1 - -### 2022-03-24 - -Allow sites to upgrade to Drush 12 when it becomes available - -## More Resources - -- [Pantheon Start States](/start-state) -- [Pantheon WordPress Upstream](/wordpress) -- [WordPress and Drupal Core Updates](/core-updates) \ No newline at end of file diff --git a/source/content/drupal-phpstorm.md b/source/content/drupal-phpstorm.md deleted file mode 100644 index 8dcd4f40de..0000000000 --- a/source/content/drupal-phpstorm.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: Configuring JetBrains PhpStorm IDE with Drupal on Pantheon -description: Best practices and recommendations for building a Drupal site using JetBrains PhpStorm. -contenttype: [doc] -innav: [true] -categories: [develop] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [local] -reviewed: "2020-01-31" -contributors: [szipfel] ---- -[JetBrains PhpStorm](https://www.jetbrains.com/phpstorm/) is a commercial PHP IDE that you can configure to work with your Drupal sites. For detailed information, see [Drupal Development Using PhpStorm](https://confluence.jetbrains.com/display/PhpStorm/Drupal+Development+using+PhpStorm) and [Developing on Pantheon with PhpStorm](https://confluence.jetbrains.com/display/PhpStorm/Developing+on+Pantheon+with+PhpStorm). - -This article covers some best practices and recommendations for building a Drupal site on Pantheon using PhpStorm. - -## Initial Site Setup - -After you've [created your site on Pantheon](/guides/legacy-dashboard/create-sites), you'll need to set up your local environment. - -### Clone the Code Repository - -Make sure your Dev environment is in Git mode, then [clone your Git repository](/guides/git/git-config) to your local workstation. - -### Create a New PhpStorm Project - -1. Open PhpStorm and create a new project from existing files. - -1. From the **Create New Project: Choose Your Scenario**, window select **Source files are in a local directory, no Web server is yet configured**, then click **next**: - - ![PHPStorm new project wizard](../images/phpstorm-newprojectwizard.png) - -1. Choose the [project directory](https://www.jetbrains.com/help/phpstorm/create-new-project-choose-project-directory.html). - -1. Select the parent folder for all the project sources and click the **Project Root** icon, or choose **Project Root** on the menu. - -1. Click **Finish**. - -## Configure a PhpStorm Project - -1. Ensure that PhpStorm uses [Drupal settings](https://www.jetbrains.com/help/phpstorm/drupal.html) by going to **Preferences** > **Languages & Frameworks** > **PHP**. - -1. Expand the Drupal dropdown. - -1. Enable Drupal integration and select the Drupal installation path. - -1. Set up PHP/Include Paths. - -1. Choose the Drupal major version. - -1. Configure the correct version of PHP by going to **Preferences** > **Languages & Frameworks** > [**PHP**](https://www.jetbrains.com/help/phpstorm/php.html), and choose PHP Language Level with the appropriate version of PHP (e.g. 8.0). - -### Drush Support - - We recommend [enabling Drush support](https://confluence.jetbrains.com/display/PhpStorm/Drupal+Development+using+PhpStorm#DrupalDevelopmentusingPhpStorm-DrupalCommandLineToolDrushIntegration). - -1. From **Preferences** > **Tools** > [**Command Line Tool Support**](https://www.jetbrains.com/help/phpstorm/command-line-tool-support.html), click **Plus**. - -1. **Choose Tool** > **Drush**, and specify the path. - - ![Drush Support](../images/phpstorm-drushsupport.png) - -## Configure On-Server Development - -1. Put your [Dev environment into SFTP mode](/guides/sftp/sftp-development), and click **Connection Info** to see the connection settings. - -1. Within PhpStorm, go to Build, Execution, Deployment > Deployment. - -1. Click **plus** for the [add server dialog](https://www.jetbrains.com/help/phpstorm/add-server-dialog.html), and choose SFTP - - ![PhpStorm on-server development settings](../images/phpstorm-onserversettings.png) - -1. Enter the Pantheon site name followed by a dash and the environment. For example, `anita-drupal-dev`. - -### Connection Tab - - [Configure the server](https://www.jetbrains.com/help/phpstorm/deployment-connection-tab.html) connection tab in the following order: - -* **SFTP Host**: SFTP Host from Connection Info -* **Port**: 2222 -* **Username**: Username from Connection Info -* **Auth Type**: Key Pair -* **Private Key File**: Navigate to the location of your `id_rsa` file. Example: `/Users/jon/.ssh/id_rsa` -* Click **Test SFTP Connection...** -* **Root Path**: Click Autodetect, then navigate to the end of the detected path and add `/code` to the end - -### Mappings Tab - -1. Deployment path on server: `/code` - -1. Web path on server: URL of your Pantheon Dev environment. Example: `https://dev-anita-drupal.pantheonsite.io` - -1. Click **OK**. - -1. Go to **Tools** > **Deployment** > **Automatic Upload** > and select the server you created. - -Now any files you change and save locally will be automatically uploaded to Pantheon. diff --git a/source/content/enterprise-billing-center.md b/source/content/enterprise-billing-center.md deleted file mode 100644 index 8c1a125406..0000000000 --- a/source/content/enterprise-billing-center.md +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Enterprise Billing Center Product Overview -description: Billing and site plan information -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [overview] -cms: [--] -audience: [development, sysadmin] -product: [enterprise-billing-center] -integration: [--] -tags: [--] -showtoc: false ---- - - - - - -Billing can be challenging, especially for businesses managing large numbers of sites. The Enterprise Billing Center provides detailed billing and site plan information for Enterprise (contract) customers. The information available here will allow you to: - -- Self-serve common billing needs - -- Determine chargebacks to internal departments - -- Provide access to billing information to your team - -- Analyze your spend across multiple contracts - -![Enterprise Billing Center](../images/enterprise-billing-center.png) - - - - - -Access all invoices and associated portfolio reports in a central location. Each report provides a detailed breakdown of all site plan changes applied to your contract: - -- All active sites in your portfolio - -- Newly added sites - -- Sites with Automatic Plan Upgrades - -- Deactivated sites - -*Site Portfolio Report* - -![Site Portfolio Charts](../images/enterprise-billing-center-invoice-report.jpg) - - - - - - -- You must be an Enterprise (contract) customer - -- You must have [Administrator privileges](/guides/account-mgmt/workspace-sites-teams/teams#change-a-users-role). - - - - - -## Documentation - -- [Enterprise Billing Center Guide](/guides/enterprise-billing-center) - -## Support - -- [Account holders](https://dashboard.pantheon.io/workspace/ee3995c4-652e-44a0-b00b-0085e92d78da/support) - -- Reach out to your Account Manager and/or respective Pantheon support contact. - - - - diff --git a/source/content/guides/account-mgmt/traffic/01-introduction.md b/source/content/guides/account-mgmt/traffic/01-introduction.md index 0e56de5d7b..23c60defd7 100644 --- a/source/content/guides/account-mgmt/traffic/01-introduction.md +++ b/source/content/guides/account-mgmt/traffic/01-introduction.md @@ -16,7 +16,7 @@ audience: [sysadmin] product: [--] integration: [--] --- -Access Metrics through the Live tab of the Site Dashboard once a [Live environment has been initialized](/add-site-dashboard#create-the-test-environment). The number of unique visits displayed in Pantheon’s Site Dashboard determines the traffic Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes other information you may use to project future traffic, including number of pages served. +Access Metrics through the Live tab of the Site Dashboard once a [Live environment has been initialized](/guides/getstarted/addsite/#create-the-live-environment). The number of unique visits displayed in Pantheon’s Site Dashboard determines the traffic Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes other information you may use to project future traffic, including number of pages served. To access metrics for another environment, use the [Terminus](/terminus) `metrics` command: diff --git a/source/content/guides/account-mgmt/workspace-sites-teams/03-workspaces.md b/source/content/guides/account-mgmt/workspace-sites-teams/03-workspaces.md index 1c208e2a23..abf695721d 100644 --- a/source/content/guides/account-mgmt/workspace-sites-teams/03-workspaces.md +++ b/source/content/guides/account-mgmt/workspace-sites-teams/03-workspaces.md @@ -132,7 +132,7 @@ Workspaces cannot be deleted. 1. [Go to the workspace](/guides/account-mgmt/workspace-sites-teams/workspaces#switch-between-workspaces) you wish to add sites to. -1. Click **Migrate Existing Site** or **Create New Site**. Refer to [Adding a Site to Pantheon](/add-site) for more details. +1. Click **Migrate Existing Site** or **Create New Site**. Refer to [Adding a Site to Pantheon](/guides/getstarted/addsite/) for more details. ### Why do login attempts fail for all users across my workspace simultaneously? diff --git a/source/content/guides/account-mgmt/workspace-sites-teams/05-sites.md b/source/content/guides/account-mgmt/workspace-sites-teams/05-sites.md index 40992810fd..ff78180dfe 100644 --- a/source/content/guides/account-mgmt/workspace-sites-teams/05-sites.md +++ b/source/content/guides/account-mgmt/workspace-sites-teams/05-sites.md @@ -34,7 +34,7 @@ To view a Site Dashboard: ## Add a Site -For guidance on how best to create or migrate a site, see [Adding a Site to Pantheon](/add-site). +For guidance on how best to create or migrate a site, see [Adding a Site to Pantheon](/guides/getstarted/addsite/). ## Manage Sites diff --git a/source/content/guides/drush/01-introduction.md b/source/content/guides/drush/01-introduction.md index 928f493e07..724dbc105a 100644 --- a/source/content/guides/drush/01-introduction.md +++ b/source/content/guides/drush/01-introduction.md @@ -26,7 +26,7 @@ Drush developers should also install and use [Terminus](/terminus), a command-li Terminus automatically uses the version of Drush it finds in `vendor/bin/drush` when running Drush commands on the platform if you have a [Composer-based site](/guides/composer). -You can run the commands below from Terminus instead of using Drush aliases. For example, you can run `terminus drush . -- cc drush` instead of `drush @pantheon.SITENAME.dev cc drush`. Refer to [Manage Drupal Sites with Terminus and Drush](/guides/terminus-drupal-site-management) for more information. +You can run the commands below from Terminus instead of using Drush aliases. For example, you can run `terminus drush . -- cc drush` instead of `drush @pantheon.SITENAME.dev cc drush`. Refer to [Manage Drupal Sites with Terminus and Drush](/guides/drush/drupal-commandline) for more information. ## Changelog diff --git a/source/content/guides/enterprise-billing-center/01-introduction.md b/source/content/guides/enterprise-billing-center/01-introduction.md index a0042ed5e2..a21658c231 100644 --- a/source/content/guides/enterprise-billing-center/01-introduction.md +++ b/source/content/guides/enterprise-billing-center/01-introduction.md @@ -40,7 +40,7 @@ Follow the steps below to access the Enterprise Billing Center. Refer to [Access ## More Resources -- [Account Management](/manage) +- [Account Management](/guides/account-mgmt) - [Traffic Limits and Overages](/guides/account-mgmt/traffic) - [Investigate and Remedy Traffic Events](/guides/account-mgmt/traffic/remedy) - [Metrics in the Site Dashboard](/guides/account-mgmt/traffic) \ No newline at end of file diff --git a/source/content/guides/enterprise-billing-center/03-site-portfolio-report.md b/source/content/guides/enterprise-billing-center/03-site-portfolio-report.md index fcbe1e0d0b..6573bb4e1e 100644 --- a/source/content/guides/enterprise-billing-center/03-site-portfolio-report.md +++ b/source/content/guides/enterprise-billing-center/03-site-portfolio-report.md @@ -59,6 +59,6 @@ This table shows any sites that were deactivated during the time between the pre ## More Resources -- [Account Management](/manage) +- [Account Management](/guides/account-mgmt) - [WordPress Best Practices](/guides/wordpress-developer/wordpress-best-practices/#avoid-xml-rpc-attacks) to disable XML-RPC traffic diff --git a/source/content/guides/getstarted/01-introduction.md b/source/content/guides/getstarted/01-introduction.md index b182b1dcdd..57d80f31b5 100644 --- a/source/content/guides/getstarted/01-introduction.md +++ b/source/content/guides/getstarted/01-introduction.md @@ -35,7 +35,6 @@ This guide will walk you through the specific steps of getting set up on Pantheo | Resource | Use this to... | |---|---| -| [Pantheon Overview](/overview) | Learn the language of Pantheon by learning about its architecture, products, workflows, and more. | | [Workspaces, Sites, and Teams](/guides/account-mgmt/workspace-sites-teams) | Learn how Workspaces, Sites, and Teams work together to help you manage your sites. | | [The Pantheon Dashboard](/guides/new-dashboard)| Get an overview of the features and functionality of the Pantheon Dashboard. diff --git a/source/content/guides/getstarted/06-addsite.md b/source/content/guides/getstarted/06-addsite.md index a5829cdb7d..1df97fd1e6 100644 --- a/source/content/guides/getstarted/06-addsite.md +++ b/source/content/guides/getstarted/06-addsite.md @@ -11,57 +11,50 @@ product: [--] integration: [--] tags: [--] contributors: [wordsmither] -reviewed: "2023-03-21" +reviewed: "2024-12-02" showtoc: true permalink: docs/guides/getstarted/addsite editpath: getstarted/addsite.md --- -There are dozens of ways to add a site on Pantheon. This section covers the most common scenarios for new users: creating a new CMS site (a site running WordPress or Drupal), or migrating an existing WordPress or Drupal site. For additional scenarios, see the [Adding a Site to Pantheon](/add-site) section at the end of this document. +There are dozens of ways to add a site on Pantheon. This section covers the most common scenarios for new users: creating a new CMS site (a site running WordPress or Drupal), or migrating an existing WordPress or Drupal site. For additional scenarios, see the [Adding a Site to Pantheon](/guides/getstarted/addsite/) section at the end of this document. ## Create a New CMS Site +Pantheon CMS site contains three components: code, files, and a database containing the content and configurations of your Content Management System (CMS). When you create a site, you are creating each of these components in the Dev environment. Then, when you are ready, you will create your Test and Live environments. -To create a CMS site: - -1. [Go to the workspace](/guides/account-mgmt/workspace-sites-teams/workspaces#switch-between-workspaces) and select the **Create New Site** button: - - ![Create new site button](../../../images/dashboard/new-dashboard/2024/create-new-site-button.png) - -1. Select **WordPress** or **Drupal**. - - ![Select CMS](../../../images/dashboard/new-dashboard/2024/create-new-site-cms.png) - - If you select Drupal, you will have the option to select the Drupal version you want to use. + - ![Select Drupal version](../../../images/dashboard/new-dashboard/2024/create-new-site-cms-drupal-11crop.png) +### Create the Dev Environment +To create a CMS site: -1. Enter the name and select a region for this site. If this site is to be part of a Professional Workspace, select a Workspace from **Choose a Workspace for the Site**. Click **Continue**. It can take several minutes to create a new site on Pantheon. + - +#### Install the CMS + - Site names are limited to 51 characters and can contain only numbers, letters, and dashes. Site names cannot start or end with a dash. +You have successfully finished adding a site in its Dev environment. Click **Visit Dev Site** to view your site. - Site names cannot be changed after site creation. +### Create the Test environment - + - ![Enter site information](../../../images/create-new-site-info.png) +You have successfully finished adding a site in its Test environment. Click **Visit Test Site** to view your site. - +### Create the Live environment - You can navigate away from this page during this process, but later, you'll have to go to the **Sites** tab to access your site. If possible, stay on this tab to simplify accessing the site when the creation is complete. +After you [purchase a plan](/guides/getstarted/purchase), you can deploy your site live. But first, you have to create the Live environment. - + -1. Click **Visit your Pantheon Site Dashboard** when the process is complete. +When you complete this step, your site will be live for anyone to see, at the Pantheon URL. For detailed information about launching your site, refer to our [Launch Essentials](/guides/launch/) guide. - ![Site creation completed](../../../images/create-site-done.png) + -At this point, you have a Dev environment for your site code, but you do not have a Dev environment for your CMS. To create that: + - +You have successfully finished adding a site in its Live environment. Click **Visit Live Site** to view your site. -You have successfully finished adding a site in its Dev environment! +At this point, you have a live site with a Pantheon URL, like `http://my-site.pantheonsite.io/`. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our [Domains on Pantheon Guide](/guides/domains) for more information. ## Migrate an Existing Site @@ -115,5 +108,5 @@ Now it's time to purchase a site plan in preparation for launching your site. * [Manually Migrate Sites to Pantheon](/migrate-manual) * [Create a Static Site Using an Empty Upstream](/static-site-empty-upstream) * [Create a Drupal Site Using a Drupal Distribution](/guides/drupal-from-dist) -* [Using Terminus to Create and Update Drupal Sites on Pantheon](/terminus-drupal-site-management/) +* [Create a Drupal Site From the Command Line Using Terminus and Drush](/guides/drush/drupal-commandline) * [Create a WordPress Site with Terminus and WP-CLI](/guides/create-wp-site) diff --git a/source/content/guides/integrated-composer/06-ic-upstreams.md b/source/content/guides/integrated-composer/06-ic-upstreams.md index cb5be1d2ac..863fed5609 100644 --- a/source/content/guides/integrated-composer/06-ic-upstreams.md +++ b/source/content/guides/integrated-composer/06-ic-upstreams.md @@ -16,7 +16,7 @@ product: [composer] integration: [--] --- -This section provides usage and maintanenance information for composer-managed [Custom Upstreams](/custom-upstreams) on Pantheon, including steps to add upstream dependencies. +This section provides usage and maintanenance information for composer-managed [Custom Upstreams](/guides/custom-upstream) on Pantheon, including steps to add upstream dependencies. ## Custom Upstreams diff --git a/source/content/guides/launch/01-introduction.md b/source/content/guides/launch/01-introduction.md index 1d57eb9571..9dbe1ff6de 100644 --- a/source/content/guides/launch/01-introduction.md +++ b/source/content/guides/launch/01-introduction.md @@ -27,7 +27,7 @@ This guide will show you how to create, configure, and launch your site on the P ## Essential Steps in This Guide -- [Create the Live environment](/add-site-dashboard#create-the-live-environment) +- [Create the Live environment](/guides/getstarted/addsite/#create-the-live-environment) - [Select Your Site Plan](/guides/launch/plans/) diff --git a/source/content/guides/launch/02-create-site-launch.md b/source/content/guides/launch/02-create-site-launch.md index 8694b9bff9..e0b86c5933 100644 --- a/source/content/guides/launch/02-create-site-launch.md +++ b/source/content/guides/launch/02-create-site-launch.md @@ -17,7 +17,7 @@ integration: [--] This section provides information on how to create your Live environment. -1. [Create a New Site](/add-site). +1. [Create a New Site](/guides/getstarted/addsite/). 1. Learn how to use [Workspaces](/guides/account-mgmt/workspace-sites-teams/workspaces). diff --git a/source/content/guides/local-development/03-lando-wordpress.md b/source/content/guides/local-development/03-lando-wordpress.md index 396d5fb8b4..e96c14d4cb 100644 --- a/source/content/guides/local-development/03-lando-wordpress.md +++ b/source/content/guides/local-development/03-lando-wordpress.md @@ -134,7 +134,7 @@ Verify that you have: - An account with Pantheon, which you can [register](https://pantheon.io/register) for free. -- A Pantheon hosted site ready to go. You can either use an existing Pantheon site or [spin up a new one](/add-site). +- A Pantheon hosted site ready to go. You can either use an existing Pantheon site or [spin up a new one](/guides/getstarted/addsite/). - A unique Pantheon [machine token](/machine-tokens). diff --git a/source/content/guides/local-development/05-wordpress-phpstorm.md b/source/content/guides/local-development/05-wordpress-phpstorm.md index 740bccd427..ab281c07d5 100644 --- a/source/content/guides/local-development/05-wordpress-phpstorm.md +++ b/source/content/guides/local-development/05-wordpress-phpstorm.md @@ -24,7 +24,7 @@ Refer to [WordPress Development using PhpStorm](https://confluence.jetbrains.com ## Create a WordPress site -[Create a new WordPress site](/add-site-dashboard) on Pantheon if you don't already have one. This site should be empty to develop your new plugin or theme. +[Create a new WordPress site](/guides/getstarted/addsite/#create-a-new-cms-site) on Pantheon if you don't already have one. This site should be empty to develop your new plugin or theme. ## Clone the Code Repository diff --git a/source/content/guides/mariadb-mysql/07-kill-mysql-queries.md b/source/content/guides/mariadb-mysql/07-kill-mysql-queries.md index 0019ea0a83..bb57527155 100644 --- a/source/content/guides/mariadb-mysql/07-kill-mysql-queries.md +++ b/source/content/guides/mariadb-mysql/07-kill-mysql-queries.md @@ -19,12 +19,6 @@ This section provides information on how to identify and kill queries with MySQL Long-running MySQL queries prevent other transactions from accessing the necessary tables to execute a request, leaving your users on hold. You can [access the environment's MySQL database](/guides/mariadb-mysql/mysql-access) to kill these queries. - - -Make your site faster. Check out our free on-demand training, where you'll learn about caching pages with our Advanced CDN, our Redis backend cache, and see how to use New Relic® Performance Monitoring for monitoring performance. - - - ## Identify Long-Running Queries 1. Create a local [MySQL connection](/guides/mariadb-mysql/mysql-access#access-your-database-directly) to the site's database. diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/01-introduction.md b/source/content/guides/migrate/manual-d8-composer-to-d8/01-introduction.md deleted file mode 100644 index a3aceb7bb8..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/01-introduction.md +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: Migrate a Composer-Managed Drupal Site from Another Platform -subtitle: Introduction -description: Learn how to migrate a site that's hosted on another platform. -contenttype: [guide] -innav: [true] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -showtoc: true -permalink: docs/guides/manual-d8-composer-to-d8 -editpath: migrate/manual-d8-composer-to-d8/01-introduction.md -reviewed: "2022-12-13" ---- - -This guide will show you how to migrate a Drupal Composer-managed site currently hosted outside of Pantheon to a Drupal Composer-managed site on Pantheon. If you to want upgrade to the latest version of Drupal, use [Migrate a Composer Managed Drupal Site from Another Platform](/guides/drupal-unhosted-composer)instead. - - - - - -## Requirements - - diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/03-prepare.md b/source/content/guides/migrate/manual-d8-composer-to-d8/03-prepare.md deleted file mode 100644 index abc1812861..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/03-prepare.md +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Prepare -description: Learn how to prepare your site for migration. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -showtoc: true -permalink: docs/guides/manual-d8-composer-to-d8/prepare -editpath: migrate/manual-d8-composer-to-d8/03-prepare.md -reviewed: "2022-12-13" ---- - -Complete all steps in this section to ensure that your site is ready to be migrated to Pantheon. - -## Create a New Site - - - -### Set Drupal Core Version - -The previous step created a site using the latest version of Drupal. To remain on the current version, set the core version as follows: - - - -## Prepare the Local Environment - - - -### Create a Local Copy of the Old Site's Code - - - -### Retrieve a Local Copy of the Pantheon Site's Code - -1. Obtain a local copy of your old site's code. - - Your code includes all custom and contributed modules or plugins, themes, and libraries. The codebase should not include the `sites/default/files` directory, or any other static assets you do not want tracked by version control. - -1. Export the database and media files (`sites/default/files`) from the old platform, but do not add them or upload any files to Pantheon. diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/05-contrib-custom.md b/source/content/guides/migrate/manual-d8-composer-to-d8/05-contrib-custom.md deleted file mode 100644 index 6e06afa3ae..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/05-contrib-custom.md +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Add Contrib and Custom Code -description: Learn how to add Contrib and custom code. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -showtoc: true -permalink: docs/guides/manual-d8-composer-to-d8/contrib-custom -editpath: migrate/manual-d8-composer-to-d8/05-contrib-custom.md -reviewed: "2021-06-22" ---- - -This section describes how to replicate your selection of contributed modules and themes, and any custom modules or themes your development team has created in your new project structure. - -## Composer packages - - - -## Custom Code - - - -### Modules and Themes - - - -### settings.php - - - -## Configuration - - diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/07-deploy-dev.md b/source/content/guides/migrate/manual-d8-composer-to-d8/07-deploy-dev.md deleted file mode 100644 index 1abb5f2a2a..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/07-deploy-dev.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Deploy to Dev -description: Learn how to deploy your site to your Dev environment. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -permalink: docs/guides/manual-d8-composer-to-d8/deploy-dev -editpath: migrate/manual-d8-composer-to-d8/07-deploy-dev.md -reviewed: "2021-06-22" ---- - - \ No newline at end of file diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/09-database.md b/source/content/guides/migrate/manual-d8-composer-to-d8/09-database.md deleted file mode 100644 index 89b615322d..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/09-database.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Add Your Database -description: Learn how to add your database. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -permalink: docs/guides/manual-d8-composer-to-d8/database -editpath: migrate/manual-d8-composer-to-d8/09-database.md -reviewed: "2021-06-22" ---- - -Now that you've configured your Pantheon Dev environment, you need to import your database by creating a `.sql` dump file. - - diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/11-files.md b/source/content/guides/migrate/manual-d8-composer-to-d8/11-files.md deleted file mode 100644 index e855fc7e9b..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/11-files.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Upload Your Files -description: Learn how to upload your files. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -permalink: docs/guides/manual-d8-composer-to-d8/files -editpath: migrate/manual-d8-composer-to-d8/11-files.md -reviewed: "2021-06-22" ---- - - diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/13-deploy-live.md b/source/content/guides/migrate/manual-d8-composer-to-d8/13-deploy-live.md deleted file mode 100644 index 51790f9d6c..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/13-deploy-live.md +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Deploy -description: Learn how to deploy your site. -contenttype: [guide] -innav: [false] -categories: [migrate] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -permalink: docs/guides/manual-d8-composer-to-d8/deploy-live -editpath: migrate/manual-d8-composer-to-d8/09-deploy-live.md -reviewed: "2022-12-13" ---- - - diff --git a/source/content/guides/migrate/manual-d8-composer-to-d8/15-troubleshooting.md b/source/content/guides/migrate/manual-d8-composer-to-d8/15-troubleshooting.md deleted file mode 100644 index 450a3fa9fb..0000000000 --- a/source/content/guides/migrate/manual-d8-composer-to-d8/15-troubleshooting.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Update a Drupal Site That Is Managed With Composer From Another Platform -subtitle: Troubleshooting -description: Learn how to troubleshoot common issues when migrating. -contenttype: [guide] -innav: [false] -categories: [migrate, troubleshooting] -cms: [drupal] -audience: [development] -product: [--] -integration: [--] -tags: [code, launch, migrate, site, updates, composer] -contributors: [wordsmither] -showtoc: true -permalink: docs/guides/manual-d8-composer-to-d8/troubleshooting -editpath: migrate/manual-d8-composer-to-d8/15-troubleshooting.md -reviewed: "2022-12-13" ---- - -This sections provides common troubleshooting scenarios. - - -## Get Messages - - - -## Rebuild Cache after Fixing Issues - - - - - diff --git a/source/content/guides/sftp/06-winscp.md b/source/content/guides/sftp/06-winscp.md index 44b3b6d2af..7479c4fa5b 100644 --- a/source/content/guides/sftp/06-winscp.md +++ b/source/content/guides/sftp/06-winscp.md @@ -47,4 +47,4 @@ This section provides information on how to use WinSCP with Pantheon. ## More Resources -- [Install Cygwin on Windows](/cygwin-windows) +- [Install Cygwin on Windows](/guides/local-development/cygwin-windows) diff --git a/source/content/guides/woocommerce/01-introduction.md b/source/content/guides/woocommerce/01-introduction.md index 4f38acc43b..6760bec044 100644 --- a/source/content/guides/woocommerce/01-introduction.md +++ b/source/content/guides/woocommerce/01-introduction.md @@ -27,7 +27,7 @@ This guide is here to help you get a WooCommerce store up and running on Pantheo * Accept orders on your ** Live** site and pull your database to your ** Test** and ** Dev** environments for future changes. ## Before You Begin -Before we get going it's important that you already have a [Pantheon account](https://pantheon.io/register) (they're free!), and you already know how to [create a site](/add-site). +Before we get going it's important that you already have a [Pantheon account](https://pantheon.io/register) (they're free!), and you already know how to [create a site](/guides/getstarted/addsite/). ### Learn the Pantheon Workflow At Pantheon we believe in workflows and processes that make developer's (and site owner's) lives better. To help with that, every site on Pantheon has three environments: ** Dev**, ** Test**, and ** Live**. diff --git a/source/content/guides/woocommerce/02-store-setup.md b/source/content/guides/woocommerce/02-store-setup.md index 2a20b459ae..a69fabbf72 100644 --- a/source/content/guides/woocommerce/02-store-setup.md +++ b/source/content/guides/woocommerce/02-store-setup.md @@ -14,7 +14,7 @@ type: guide permalink: docs/guides/woocommerce/store-setup/ editpath: woocommerce/02-store-setup.md --- -I've already gone ahead and [created a new site on Pantheon](/add-site). +I've already gone ahead and [created a new site on Pantheon](/guides/getstarted/addsite/). ![New Pantheon Site Dashboard](../../../images/guides/woocommerce/01-new-pantheon-site.png) diff --git a/source/content/guides/wordpress-pantheon/08-wordpress-developers.md b/source/content/guides/wordpress-pantheon/08-wordpress-developers.md index ef58cc165d..42316c1fa2 100644 --- a/source/content/guides/wordpress-pantheon/08-wordpress-developers.md +++ b/source/content/guides/wordpress-pantheon/08-wordpress-developers.md @@ -24,7 +24,7 @@ View our [WordPress Command Line](/guides/wp-cli) guide for steps to create and ## Run WordPress as a Backend API -Pantheon supports [running WordPress as an API](/headless) (Application Programming Interface) for the backend of headless sites, which enables the CMS to interact with external frontend applications over HTTP requests. +Pantheon supports [running WordPress as an API](/guides/decoupled) (Application Programming Interface) for the backend of headless sites, which enables the CMS to interact with external frontend applications over HTTP requests. ## WordPress on Pantheon Developer Best Practices diff --git a/source/content/headless.md b/source/content/headless.md deleted file mode 100644 index 7f60e3b636..0000000000 --- a/source/content/headless.md +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: Running WordPress and Drupal as a Backend API -description: Learn about headless development models for decoupled architecture on Pantheon. -tags: [modules, plugins] -contributors: [eabquina, rachelwhitton] -contenttype: [doc] -innav: [true] -categories: [api] -cms: [drupal, wordpress] -audience: [agency, development] -product: [--] -integration: [--] ---- -Pantheon supports running WordPress and Drupal as an API (Application Programming Interface) for the backend of headless sites, which enables the CMS to interact with external frontend applications over HTTP requests. - -For example, a mobile application that uses the `GET`, `POST`, and `DELETE` HTTP methods to perform CRUD operations on a CMS's database . - -## Decoupled Architecture Overview -WordPress and Drupal are traditionally monolithic CMSs, meaning they serve as the frontend and backend of a site. Decoupled architecture (**headless**) is a development model that uses a CMS to manage content in the backend with a completely separate frontend component to render that content in the browser. - -Some key differences of decoupled architecture include: - -
- -
- -
-

- - ![Decoupled Frontend](../images/decoupledcms-what-is-decoupled.png) - - **Decoupled Frontend**
- Presentation can be handled in a variety of ways, from interactive JS frameworks like Angular, to static generators, to mobile apps, or even another CMS. Multiple frontends can peacefully coexist. -

-
-
-
-
-

- - ![Content Via Web Service API](../images/decoupledcms-what-is-content.png) - - **Content Via Web Service API**
- The content for the site is accessible via a web-service API, usually in a RESTful manner and in a mashup-friendly format such as JSON. -

-
-
-
-
-

- - ![CMS Backend and Database](../images/decoupledcms-what-is-backend.png) - - **CMS Backend and Database**
- There is a traditional database-driven CMS which editors use to maintain the content for the site, usually via the same admin interface as always. -

-
-
-
- -### Pantheon's Platform Benefits -Backend APIs running on Pantheon take advantage of the following platform features for optimal performance: - -* [**Global CDN**](/guides/global-cdn): Cache backend API responses from WordPress or Drupal in 40+ global CHI metro POPs (points of presence). -* **Redis**: Leverage object caching for backend APIs that use the database-driven admin interface of the CMS to edit or add content. For details, see the following: - * [Object Cache Overview](/object-cache) - * [Enable Object Cache Pro for WordPress](/object-cache/wordpress) - * [Enable Object Cache for Drupal](/object-cache/drupal) - - - -## Exposing the Backend API -Running WordPress and Drupal as an API on Pantheon can be done on any Drupal or WordPress upstream. The process to [create](/guides/legacy-dashboard/create-sites), [update core](/core-updates), and [launch](/guides/launch) a backend API on Pantheon does not deviate from the standard procedures. - - - - - -Since WordPress 4.7, the WordPress API is included as part of core. There's no action needed to expose the API on Pantheon. Explore default routes and endpoints like `/wp-json/wp/v2/posts` in your browser: - -![default routes wp](../images/wp-json-posts.png) - -We recommend using a trusted browser extension to format the JSON response from the API so it's easier to read. - -Refer to the [Rest API Handbook](https://developer.wordpress.org/rest-api/) from WordPress.org's Developer Resources for full documentation on this web service. - - - - - -Web Services are implemented through various plugins in Drupal. - - - [RESTful](https://www.drupal.org/project/restful) - - [RESTful Web Services](https://www.drupal.org/project/restws) - - [Services](https://www.drupal.org/project/services) - -The service module has several integration features, and other web service formats. It also has [several supporting modules](https://www.drupal.org/node/750036) that extend the Drupal functionalities made available to the API. - - - -While not a REST API service by itself, you can create a JSON view using the [Views Datasource](https://www.drupal.org/project/views_datasource) module. - - - - - - - -## Frequently Asked Questions - -### Can I use other frameworks or distributions? -You can use [custom upstreams](/guides/custom-upstream), [make your own build](/guides/build-tools) or [install distributions](/start-state/#public-distributions) that may serve as a backend API. For example, [Contenta](http://www.contentacms.org) can be used on the platform. - -### How can I troubleshoot the backend API? -We recommend using one of the following Chrome extensions to debug HTTP requests: - -* [Postman](https://chrome.google.com/webstore/detail/postman/fhbjgbiflinjbdggehcddcbncdddomop?hl=en) -* [Dev HTTP Client](https://chrome.google.com/webstore/detail/dev-http-client/aejoelaoggembcahagimdiliamlcdmfm/related) -* [Restlet Client](https://chrome.google.com/webstore/detail/restlet-client-rest-api-t/aejoelaoggembcahagimdiliamlcdmfm) diff --git a/source/content/migrate-wordpress-multisite.md b/source/content/migrate-wordpress-multisite.md index 05966c1824..4399755933 100644 --- a/source/content/migrate-wordpress-multisite.md +++ b/source/content/migrate-wordpress-multisite.md @@ -219,5 +219,4 @@ For you to be able to access your WPMS in different environments, you need to en ## More Resources * [Migrate Sites to Pantheon](/guides/guided/) -* [Guided WordPress Migrations (video)](/migrate-wordpress) * [WordPress Launch Check](/guides/wordpress-pantheon/wordpress-launch-check) diff --git a/source/content/migrate-wordpress.md b/source/content/migrate-wordpress.md deleted file mode 100644 index 8642489aae..0000000000 --- a/source/content/migrate-wordpress.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Guided WordPress Migrations -description: Learn how to migrate existing WordPress sites using the migration plugin. -contributors: [scottmassey] -permalink: docs/:basename -tags: [migrate] -layout: video -type: video -searchboost: 50 -contenttype: [doc] -innav: [true] -categories: [migrate] -cms: [wordpress] -audience: [development] -product: [--] -integration: [--] ---- - - - -Pantheon has a guided path for migrating sites onto our platform. This method gets most sites on board. Let’s click on the Migrate Existing Site button to start the process. - -We give our new destination-site on Pantheon a name. And we install and activate the migration plugin on our legacy site, as instructed. - -It takes a few minutes as it migrates code, database, and files. But then it’s done. That’s it—migrated! - -We give you a guided path for most sites. If you can’t get your site on the platform, let us know so we can help you. - -## More Resources - -- [The Quickstart Guide to Migrating a WordPress Site](https://pantheon.io/resources/quickstart-guide-migrating-wordpress-site) diff --git a/source/content/newrelic.md b/source/content/newrelic.md deleted file mode 100644 index cc35854b23..0000000000 --- a/source/content/newrelic.md +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: New Relic Product Overview -description: Monitor your application performance -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [overview] -cms: [--] -audience: [development, sysadmin] -product: [dashboard] -integration: [--] -tags: [--] -showtoc: false ---- - - - - - -[New Relic® Performance Monitoring](https://newrelic.com/) offers a wide array of metrics that provide a nearly real-time look into the performance of a web application. New Relic® makes it easy for you to monitor your performance and speed up the support process by helping our support team visualize corresponding performance and symptoms. - -On Pantheon, most plans come with free New Relic APM Pro, giving you code-level visibility into your website’s performance. You can track releases, investigate query performance, and identify areas for improvement with New Relic's software analytics tool suite. - -![New Relic](../images/integrations/newrelic/new-relic-get-started.png) - - - - - - -* Real-time instrumentation and analytics -* Flexible instrumentation and dashboarding -* Guides appropriate engineer responses -* Correlates application performance to end-user experience -* Connects application and infrastructure performance -* Rich, detailed transaction data -* Real-time error analysis with on-demand diagnostic tools -* Integration with DevOps tooling -* Cloud-service instrumentation - -*Deployments View* - -![View Deployments](../images/integrations/newrelic/deploy_tab.png) - -*Summary View* - -![Summary view](../images/integrations/newrelic/new-relic-summary.png) - - - - - -All [Pantheon plans](https://pantheon.io/plans/pricing) except for a Basic plan can use New Relic®. New Relic® is available to free Sandbox site plans for developmental purposes, but will not be available when your Basic plan goes live. - -* Sandbox (for development only), Performance, or Elite plan - - - - - -## Documentation - -* [New Relic at Pantheon Guide](/guides/new-relic) - -## Resources at New Relic - -* [Documentation](https://docs.newrelic.com/) -* [Community Forum](https://forum.newrelic.com/s/) -* [New Relic University](https://learn.newrelic.com/) - -## Learning - -* [New Relic Training](https://learning.pantheon.io/new-relic-training) - -## Support - -* [Users with Pantheon Accounts](https://dashboard.pantheon.io/workspace/support) - - - - \ No newline at end of file diff --git a/source/content/pantheon-yml-overview.md b/source/content/pantheon-yml-overview.md deleted file mode 100644 index 664ddeacd4..0000000000 --- a/source/content/pantheon-yml-overview.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: The Pantheon.yml Configuration File -description: Configure our platform for your needs. -contributors: [davidneedham] -permalink: docs/:basename -tags: [site, code] -layout: video -type: video -searchboost: 50 -contenttype: [doc] -innav: [true] -categories: [config] -cms: [drupal, wordpress] -audience: [development] -product: [--] -integration: [nginx, varnish] ---- - - - -The [pantheon.yml](/pantheon-yml) file provides a way to configure platform options for any project. This file is version controlled and can be configured differently for each environment. - -Configurable items include: PHP version, Drush version, protected paths, nested docroot, and [Quicksilver](/guides/quicksilver) platform hooks. - -Items such as Nginx configuration or Varnish settings are not editable. - -Let's look at an example of upgrading a site to PHP7 with pantheon.yml. - -We’ll start by creating a [Multidev](/guides/multidev) environment for testing in a separate and safe space. - -Now we’ll create a pantheon.yml file for the Multidev branch, set the PHP version to 7, and commit the pantheon.yml file to the Multidev environment. - -The Multidev environment should be thoroughly tested to make sure there are no issues with PHP7 and the codebase. - -It's also a good idea to check the [PHP error logs](/guides/logs-pantheon) to see if any issues are reported. - -When the site has been tested to your satisfaction, the Multidev environment can be merged into Dev and eventually deployed into Test and Live. - -The pantheon.yml file allows you to change platform configuration, is tracked in version control, and can be specific to any environment. diff --git a/source/content/partials/transfer-ownership-billing-intro.md b/source/content/partials/transfer-ownership-billing-intro.md index 4747e41c03..0641461248 100644 --- a/source/content/partials/transfer-ownership-billing-intro.md +++ b/source/content/partials/transfer-ownership-billing-intro.md @@ -14,4 +14,4 @@ A transfer of ownership is the most common way non-agency developers and Registe Single-site businesses can also use this method when site ownership needs to be transferred to someone else within the company. The invitation will guide the recipient through adding their payment method to the site for the designated plan. -We recommend communicating with the business owner well in advance of sending a transfer request. It's a good idea to have them notify you once they've upgraded so you can continue the going live procedure. Feel free to share the [Account Management](/manage) guide with them. +We recommend communicating with the business owner well in advance of sending a transfer request. It's a good idea to have them notify you once they've upgraded so you can continue the going live procedure. Feel free to share the [Account Management](/guides/account-mgmt) guide with them. diff --git a/source/content/platform-upgrade.md b/source/content/platform-upgrade.md deleted file mode 100644 index f33a479e3f..0000000000 --- a/source/content/platform-upgrade.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Deployment Infrastructure Upgrade -description: Details on the current infrastructure upgrade. -tags: [dashboard, updates] -contenttype: [doc] -innav: [true] -categories: [deploy] -cms: [drupal, wordpress] -audience: [development] -product: [--] -integration: [--] ---- - -If your site dashboard displays the following **Deployment Infrastructure Upgrade** notice, we recommend waiting to make code changes until maintenance completes: - -![deployment infrastructure upgrade](../images/upgrade-notice.png) - -Refer to the following FAQs for more details and if you have concerns surrounding this process. -## Frequently Asked Questions - -### Does it affect my site uptime? - -No. We can assure you that there will be zero downtime on your site. - -### What features are affected? - -During this upgrade, services related to development may be interrupted. As a precaution, until the upgrade is complete, you should delay: - -- Making changes using SFTP mode -- Pushing code with git -- Merging from multi-dev -- Cloning a database across environments -- Creating new multi-devs -- Deploying to LIVE environment - -### How long will the upgrade take? - -For most of the sites, we estimate the upgrade to complete in under 30 minutes. However, for some sites with large databases, the upgrade my take longer. - -If you have questions around timing and duration of the upgrade, kindly [contact support](https://dashboard.pantheon.io/#support). - -### What are you upgrading? - -This upgrade is for the underlying infrastructure only. This upgrade does not change any runtime or software versions and there are no change to the behavior of Pantheon. Other that this brief interruption, there is no impact to the users. - - -Do not hesitate to contact support if you have any additional questions or concerns. diff --git a/source/content/products.md b/source/content/products.md index d734cb151c..2ea1a5fcac 100644 --- a/source/content/products.md +++ b/source/content/products.md @@ -96,7 +96,7 @@ Pantheon offers a wide array of products and features to simplify building and m - + New Relic® Performance Monitoring provides a nearly real-time look into the performance of a web application. @@ -108,7 +108,7 @@ Pantheon offers a wide array of products and features to simplify building and m - + Access complete platform functionality from our integrated command line. diff --git a/source/content/sign-up.md b/source/content/sign-up.md deleted file mode 100644 index 7fec91b246..0000000000 --- a/source/content/sign-up.md +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: Sign Up for an Account -description: Quickly sign up for an account and get started building your site. -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [overview] -cms: [--] -audience: [agency, business, development, sysadmin] -product: [--] -integration: [--] -tags: [--] ---- - -Creating a Pantheon account requires just a few pieces of information, and **does not require** providing a payment method. - -To create an account: - -1. Go to the [Registration page](https://pantheon.io/register?docs). - -1. Enter your name, email, company name, password, country and state. - -1. Read and accept the terms of service. - -1. Click **Create Account**. Your account will be created (it may take a few moments), and a login page will appear. - -When you log in for the first time, there will be a welcome screen where you can choose to: - -- [Create a new site](/add-site/) - -- [Migrate an existing site](/get-started) - -- [Set up your team](/guides/account-mgmt/workspace-sites-teams/teams) - -![A screenshot of the welcome screen for the New Dashboard](../images/dashboard/new-dashboard/welcome-screen.png) - -## More Resources - -- [Get Started](/get-started) diff --git a/source/content/supported-drupal.md b/source/content/supported-drupal.md index e64ce54f9c..8515250220 100644 --- a/source/content/supported-drupal.md +++ b/source/content/supported-drupal.md @@ -25,7 +25,7 @@ The following table indicates availability of the specified Drupal versions, as | 6 | ❌ | ❌ | ❌ | ## Drupal 10 and 11 on Pantheon -Refer to [Create a New CMS Site](/add-site-dashboard) for how to create a new Drupal 10 or 11 site from the Pantheon dashboard. +Refer to [Create a New CMS Site](/guides/getstarted/addsite/#create-a-new-cms-site) for how to create a new Drupal 10 or 11 site from the Pantheon dashboard. If you already have a Drupal 10 site on Pantheon, you can upgrade your existing site to [Drupal 11 via Composer](https://www.drupal.org/docs/upgrading-drupal/upgrading-from-drupal-8-or-later/how-to-upgrade-from-drupal-10-to-drupal-11). @@ -37,7 +37,7 @@ terminus site:create