이 문서에서는 IntelliJ 기반의 App Engine 프로젝트를 IntelliJ용 Cloud Code로 마이그레이션하는 방법을 설명합니다.
시작하기 전에
프로젝트가 Maven 또는 Gradle 기반이고 이전의 App Engine SDK 기반 플러그인(예: com.google.appengine.appengine-maven-plugin 및 com.google.appengine:gradle-appengine-plugin)을 사용하는 경우에는 먼저 새로운 gcloud CLI 기반의 Maven 및 Gradle 플러그인으로 마이그레이션해야 합니다.
새 플러그인은 Datanucleus 향상을 지원하지 않습니다. 이 기능을 사용하는 경우 프로젝트를 Cloud Code로 마이그레이션하려면 Datanucleus(JDO, JPA) 향상을 수동으로 구성해야 합니다.
Cloud Datastore에서 읽기/쓰기를 수행할 때 Objectify를 ORM 레이어로 사용해야 합니다.
새 플러그인 설치
아직 플러그인을 설치하지 않았다면 다음 안내에 따라 설치하세요.
머신의 PATH에 지원되는 IDE 버전, JetBrains IDE 버전 2022.3 이상(예: IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand)이 있는지 확인합니다.
IntelliJ IDEA 또는 기타 지원되는 JetBrains IDE를 엽니다.
File(파일) > Settings(설정) > Plugins(플러그인)를 사용하여 플러그인 마켓 창을 엽니다. Mac OS X의 경우 IntelliJ IDEA > Preferences(환경설정) > Plugins(플러그인)을 사용합니다.
'Cloud Code' 플러그인을 검색하여 설치합니다.
IDE를 다시 시작하여 플러그인을 활성화하라는 메시지가 표시될 수 있습니다.
IntelliJ 및 프로젝트 구성
플러그인을 설치한 후 다음과 같이 IntelliJ와 프로젝트가 새 플러그인을 사용하도록 구성하세요.
새 플러그인이 기존 App Engine 통합과 충돌한다는 알림이 표시되면 알림 메시지에서 링크를 클릭합니다.
다음 플러그인 사용 중지 프롬프트에서 '사용 중지 및 재시작'을 선택하여 App Engine 플러그인을 사용 중지하고 플러그인 구성 변경사항이 적용되도록 IDE를 재시작합니다.
프로젝트가 이전 형식이라는 알림이 나타나면 프로젝트를 새 형식으로 Convert(변환)하는 옵션을 클릭합니다.
기존 App Engine Server와 Cloud 인스턴스를 삭제하고 새 gcloud CLI를 사용하여 다시 만들어야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eThis guide explains the process of migrating App Engine projects from IntelliJ to Cloud Code for IntelliJ, focusing on necessary configurations and plugin installations.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code supports Java 8 runtimes, but due to the impending deprecation of Java 8 support for App Engine, it is disabled by default and creating new App Engine projects is discouraged.\u003c/p\u003e\n"],["\u003cp\u003eBefore migrating, Maven or Gradle projects using older App Engine SDK plugins should switch to the new gcloud CLI-based plugins, as well as migrate from Datanucleus enhancement.\u003c/p\u003e\n"],["\u003cp\u003eUsers must install the Cloud Code plugin, disable the old App Engine plugin, convert their project format, delete old App Engine server and cloud instances, and ensure they use the latest version of Gradle and Maven App Engine plugins.\u003c/p\u003e\n"],["\u003cp\u003eIntelliJ-specific projects must remove old App Engine SDK dependencies and use the App Engine Facet library import feature to retrieve necessary dependencies from Maven Central, allowing for deletion of the old App Engine SDK.\u003c/p\u003e\n"]]],[],null,["# Migrate to Cloud Code for IntelliJ\n\nThis document describes how to migrate your IntelliJ-based App Engine project\nto Cloud Code for IntelliJ.\n| **Caution:** As of January 31, 2024, Java 8 support for App Engine has ended, and will be deprecated on January 31, 2026. As a result, Cloud Code disables App Engine by default. To enable App Engine in your IDE, navigate to **Settings** \\\u003e **Google\n| Cloud Code** \\\u003e **App Engine** . Due to the upcoming deprecation of App Engine, we don't recommend creating new App Engine projects. For more information about App Engine deprecations, see [Feature deprecations](/appengine/docs/standard/deprecations). For more information about the runtime support schedule for App Engine, see [Runtime support schedule](/appengine/docs/standard/lifecycle/support-schedule).\n\nBefore you begin\n----------------\n\n- If your project is Maven or Gradle based and uses the older\n App Engine SDK based plugins (e.g.\n `com.google.appengine.appengine-maven-plugin` and\n `com.google.appengine:gradle-appengine-plugin`), you should first migrate to\n the new gcloud CLI based\n [Maven](/appengine/docs/standard/java/tools/migrate-maven)\n and\n [Gradle](/appengine/docs/standard/java/tools/migrate-gradle)\n plugins.\n\n- The new plugin does not support Datanucleus enhancement. If you depend on\n this feature, you will have to manually configure Datanucleus\n ([JDO](/appengine/docs/standard/java/datastore/jdo/overview-dn2),\n [JPA](/appengine/docs/standard/java/datastore/jpa/overview-dn2))\n enhancement for your project to migrate to Cloud Code.\n You should use\n [Objectify](/appengine/docs/legacy/standard/java/datastore#using_objectify_with)\n as your ORM layer when reading/writing to Datastore.\n\nInstall the new plugin\n----------------------\n\nIf you haven't already, install the plugin by doing the following:\n\n- Ensure you have the supported IDE version, JetBrains IDE version 2022.3+ (such as IntelliJ Ultimate/Community, PyCharm Professional/Community, WebStorm, GoLand), on the `PATH` of your machine.\n- Open IntelliJ IDEA (or any supported JetBrains IDE).\n- Open the plugins marketplace window using **File** \\\u003e **Settings** \\\u003e **Plugins** . For Mac OS X, use **IntelliJ IDEA** \\\u003e **Preferences** \\\u003e **Plugins**.\n- Search for the 'Cloud Code' plugin and install it.\n\n You may be prompted to restart your IDE to activate the plugin.\n\nConfigure IntelliJ and your project\n-----------------------------------\n\nAfter installing the plugin, configure IntelliJ and your project to use the new\nplugin as follows:\n\n1. When notified that the new plugin conflicts with the existing\n App Engine integration, click the link in the prompt.\n\n2. In the following Disable Plugin prompt, select 'Disable and Restart' to\n disable the App Engine plugin and restart the IDE for the plugin\n configuration changes to take effect.\n\n3. When notified that your project is in an old format, click the option to\n **Convert** your project to the new format.\n\n4. You should delete your existing App Engine Server and Cloud\n instances and recreate them using the new gcloud CLI.\n\n 1. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Application Servers**.\n\n 2. Select your **App Engine Dev** instances and click\n **Delete** (-).\n\n 3. Click **Add** (+) and select **Google App Engine Dev Server**.\n\n 4. Navigate to **Settings** \\\u003e **Build, Execution, Deployment** \\\u003e\n **Clouds**.\n\n 5. Select your **Google App Engine** cloud instances and click\n **Delete** (-).\n\n 6. Click **Add** (+) to configure an App Engine cloud deployment\n target.\n\n5. If you have any App Engine local server run configurations, then\n you must update them to use the newly configured Application Server.\n\n6. Navigate to **Tools** \\\u003e **Cloud Code** \\\u003e **App Engine** to see the list of actions\n available to you for running and deploying your application, or view\n [the documentation](/code/docs/intellij/how-to) for more information.\n\n7. For Maven or Gradle-based projects, ensure that you are using the latest\n version of the Gradle and Maven App Engine plugins.\n\nConfiguring IntelliJ-specific projects\n--------------------------------------\n\nFor IntelliJ-specific projects only (i.e., projects that have manually configured\nproject settings with the old App Engine facet and are not synced from\nGradle or Maven), update your App Engine dependencies.\n\nYour App Engine dependencies are still configured as\n'External Libraries' and provided by your old App Engine SDK\ninstallation. If you delete your App EngineSDK installation, your\napplication will not compile.\n\nTo remove this dependency on the old App Engine SDK, configure your\nApp Engine API dependencies using the App Engine Facet\nlibrary import feature as follows:\n\n1. Users of the old plugin's Datanucleus JDO/JPA enhancement feature need to\n port their applications to Maven or Gradle as Datanucleus enhancement is not\n supported by the Cloud Code plugin.\n\n2. From the IntelliJ Project Structure UI, navigate to your App Engine\n Standard module's dependencies tab.\n\n3. Remove all App Engine related libraries.\n\n4. In the same Project Structure UI, navigate to your App Engine\n module's **Google App Engine** facet.\n\n5. In the **Libraries** panel, select the App Engine dependencies you\n are using.\n\n This action will automatically retrieve these dependencies from Maven\n Central and add them to your module classpath.\n6. Run locally and deploy to verify your new configuration is working.\n\n7. At this point, you can safely delete your old App Engine SDK.\n\nGet support\n-----------\n\nTo submit feedback or report an issue in your IntelliJ IDE, go to **Tools** \\\u003e **Cloud Code** \\\u003e **Help / About** \\\u003e **Submit\nfeedback or report an issue** to report an issue on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-intellij/issues)."]]
