すべてのプロダクト
Search
ドキュメントセンター

Function Compute:コードパッケージのコンパイルとデプロイ

最終更新日:Sep 11, 2024

このトピックでは、MavenまたはServerless Devsを使用してJavaランタイムでプログラムをコンパイルし、プログラムをZIPまたはJARファイルとしてパッケージ化する方法について説明します。 コードをコンパイルしてパッケージ化した後、Function ComputeコンソールまたはServerless Devsを使用してコードパッケージをアップロードできます。

Javaランタイムの依存関係ライブラリ

コードパッケージを作成して配置するには、関数コードと依存関係ライブラリをZIPファイルまたはJARファイルとしてコンパイルしてパッケージ化する必要があります。

Function Computeは、Javaランタイムに次の依存関係ライブラリを提供します。

  • com.aliyun:fc-java-core: リクエストハンドラーで使用されるハンドラーインターフェイスやコンテキストオブジェクトなどの情報を定義します。

  • com.aliyun:fc-java-events: 一般的なイベントソースのイベントタイプを提供します。

Maven中央リポジトリを使用して、上記の依存関係を取得できます。 上記の依存関係ライブラリを取得したら、pom.xmlファイルに追加します。 次のサンプルコードに例を示します。

<!-- https://mvnrepository.com/artifact/com.aliyun.fc.runtime/fc-java-core -->
<dependency>
    <groupId>com.aliyun.fc.runtime</groupId>
    <artifactId>fc-java-core</artifactId>
    <version>1.4.1</version>
</dependency>

<!-- https://mvnrepository.com/artifact/com.aliyun.fc.runtime/fc-java-event -->
<dependency>
    <groupId>com.aliyun.fc.runtime</groupId>
    <artifactId>fc-java-event</artifactId>
    <version>1.2.0</version>
</dependency>
説明

依存関係パッケージが大きすぎる場合は、依存関係をレイヤーにパッケージ化して、コードパッケージのサイズを減らすことができます。 詳細については、「カスタムレイヤーの作成」をご参照ください。

Mavenを使用したコードパッケージのコンパイルとデプロイ

あなたが始める前に

JavaとMavenがインストールされています。 Javaの詳細については、Java公式Webサイトをご覧ください。 Mavenの詳細については、「Apache Mavenのインストール」をご参照ください。

手順

  1. Javaプロジェクトを作成します。 次のサンプルコードは、App.javaファイルのパスを提供します。

    src/main/java/example/App.java  

    次のサンプルコードをApp.javaファイルに追加します。詳細なサンプルコードについては、「イベントハンドラー」、「HTTPハンドラー」、または「コンテキスト」をご参照ください。

    package example;
    
    import com.aliyun.fc.runtime.Context;
    import com.aliyun.fc.runtime.StreamRequestHandler;
    
    import java.io.IOException;
    import java.io.InputStream;
    import java.io.OutputStream;
    
    public class App implements StreamRequestHandler {
    
        @Override
        public void handleRequest(InputStream inputStream, OutputStream outputStream, Context context) throws IOException {
            outputStream.write(new String("hello world").getBytes());
        }
    }
    
  2. pom.xmlファイルで、ビルドを設定します。 サンプルコード:

    <build>
            <plugins>
                  <plugin>
                      <groupId>org.apache.maven.plugins</groupId>
                      <artifactId>maven-shade-plugin</artifactId>
                      <version>3.2.1</version>
                      <executions>
                        <execution>
                          <phase>package</phase>
                          <goals>
                            <goal>shade</goal>
                          </goals>
                          <configuration>
                            <filters>
                              <filter>
                                <artifact>*:*</artifact>
                                <excludes>
                                  <exclude>META-INF/*.SF</exclude>
                                  <exclude>META-INF/*.DSA</exclude>
                                  <exclude>META-INF/*.RSA</exclude>
                                </excludes>
                              </filter>
                            </filters>
                          </configuration>
                        </execution>
                      </executions>
                  </plugin>
            </plugins>
    </build>
    説明

    Apache Maven ShadeまたはApache Mavenアセンブリを使用できます。 上記の例では、例としてApache Maven Shadeを使用しています。

    展開して、pom.xmlファイルの完全な例を表示します

    <project xmlns="http://maven.apache.org/POM/4.0.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
      <modelVersion>4.0.0</modelVersion>
      <groupId>example</groupId>
      <artifactId>HelloFCJava</artifactId>
      <packaging>jar</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>HelloFCJava</name>
    
      <dependencies>
        <dependency>
          <groupId>junit</groupId>
          <artifactId>junit</artifactId>
          <version>3.8.1</version>
          <scope>test</scope>
        </dependency>
        <dependency>
          <groupId>com.aliyun.fc.runtime</groupId>
          <artifactId>fc-java-core</artifactId>
          <version>1.4.1</version>
        </dependency>
      </dependencies>
    
      <build>
        <plugins>
            <plugin>
              <groupId>org.apache.maven.plugins</groupId>
              <artifactId>maven-shade-plugin</artifactId>
              <version>3.2.1</version>
              <executions>
                <execution>
                  <phase>package</phase>
                  <goals>
                    <goal>shade</goal>
                  </goals>
                  <configuration>
                    <filters>
                      <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                          <exclude>META-INF/*.SF</exclude>
                          <exclude>META-INF/*.DSA</exclude>
                          <exclude>META-INF/*.RSA</exclude>
                        </excludes>
                      </filter>
                    </filters>
                  </configuration>
                </execution>
              </executions>
            </plugin>
        </plugins>
      </build>
    
      <properties>
        <maven.compiler.target>1.8</maven.compiler.target>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.test.skip>true</maven.test.skip>
      </properties>
    </project>
  3. CLIを開き、プロジェクトのルートディレクトリに切り替えて、mvnクリーンパッケージコマンドを実行してパッケージングを実行します。

    サンプルコード:

    [INFO] Scanning for projects...
     ...  ....   ....
    [INFO] --------------------------< example:example >---------------------------
    [INFO] Building java-example 1.0-SNAPSHOT
    [INFO] --------------------------------[ jar ]---------------------------------
     ...  ....   ....
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  11.681 s
    [INFO] Finished at: 2020-03-26T15:55:05+08:00
    [INFO] ------------------------------------------------------------------------
    • コンパイルが失敗した場合は、エラーメッセージに基づいてコードを変更します。

    • コンパイルが成功すると、コンパイルされたJARファイルはプロジェクトフォルダーのtargetディレクトリにあり、pom.xmlartifactIdフィールドとversionフィールドに従ってHelloFCJava-1.0-SNAPSHOT.jarという名前になります。

      重要

      macOSおよびLinuxオペレーティングシステムの場合は、圧縮前にコードファイルが読み取り可能で実行可能であることを確認してください。

  4. Function Computeコンソールコードパッケージをアップロードします。

    image

  5. [設定] タブで、[ハンドラー] の値を確認します。 ハンドラーは、[パッケージ名].[クラス名]::[メソッド名] 形式に従う必要があります。 たとえば、パッケージ名がexample、クラス名がApp、メソッド名がhandleRequestの場合、ハンドラーはexample.App::handleRequestのように設定できます。 有効でない場合は、[変更] をクリックしてハンドラーを変更できます。

    image

  6. On theコードタブをクリックします。テスト機能関数をテストします。

    image

Serverless Devsを使用したコードパッケージのコンパイルとデプロイ

あなたが始める前に

手順

  1. 次のコマンドを実行して、プロジェクトを初期化します。

    s init devsapp/start-fc-event-java8 -d start-fc-event-java8
    • s init devsapp/start-fc-event-java8: イベントハンドラーテンプレートに基づいてプロジェクトを初期化します。

    • -d start-fc-event-java8: 指定したディレクトリにプロジェクトファイルを出力します。

    コマンドを実行した後、リージョン、サービス名、および関数名を選択し、プロンプトに従ってキーを設定します。

    説明

    プロンプトに従ってs initコマンドを実行してテンプレートを選択することもできます。

  2. 次のコマンドを実行して、プロジェクトディレクトリに移動します。

    cd start-fc-event-java8
  3. 次のコマンドを実行して、プロジェクトをデプロイします。

    s deploy

    このコマンドを実行すると、pre-deployコマンドが最初に実行されます。 pre-deployコマンドを実行すると、mvn packageコマンドを使用してコンパイルとパッケージングが実行されます。 その後、コードパッケージがアップロードされ、デプロイされます。 サンプルコマンド出力:

    [2022-04-07 12:00:09] [INFO] [S-CORE] - Start the pre-action
    [2022-04-07 12:00:09] [INFO] [S-CORE] - Action: mvn package
    [INFO] Scanning for projects...
    [INFO]
    [INFO] ------------------------< example:HelloFCJava >-------------------------
    [INFO] Building HelloFCJava 1.0-SNAPSHOT
    [INFO] --------------------------------[ jar ]---------------------------------
    ......
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  3.617 s
    [INFO] Finished at: 2022-04-07T20:00:14+08:00
    [INFO] ------------------------------------------------------------------------
    [2022-04-07 12:00:14] [INFO] [S-CORE] - End the pre-action
    
     Checking Service, Function (0.64s)
     Creating Service, Function (0.71s)
    
    Tips for next step
    ======================
    * Display information of the deployed resource: s info
    * Display metrics: s metrics
    * Display logs: s logs
    * Invoke remote function: s invoke
    * Remove Service: s remove service
    * Remove Function: s remove function
    * Remove Trigger: s remove trigger
    * Remove CustomDomain: s remove domain
    
    
    
    helloworld:
      region:   cn-hangzhou
      service:
        name: hello-world-service
      function:
        name:       start-fc-event-java8
        runtime:    java8
        handler:    example.App::handleRequest
        memorySize: 128
        timeout:    60
  4. s invokeコマンドを実行してテストを実行します。

    サンプルコマンド出力:

    ➜ start-fc-event-java8 s invoke
    ========= FC invoke Logs begin =========
    FC Initialize Start RequestId: b246c3bf-06bc-49e5-92b8-xxxxxxxx
    FC Initialize End RequestId: b246c3bf-06bc-49e5-92b8-xxxxxxxx
    FC Invoke Start RequestId: b246c3bf-06bc-49e5-92b8-xxxxxxxx
    FC Invoke End RequestId: b246c3bf-06bc-49e5-92b8-xxxxxxxx
    
    Duration: 7.27 ms, Billed Duration: 8 ms, Memory Size: 128 MB, Max Memory Used: 65.75 MB
    ========= FC invoke Logs end =========
    
    FC Invoke Result:
    hello world
    
    
    
    End of method: invoke