상단
  • 서비스 소개
    • 서비스 소개
    • 공지 사항
  • Force.com Migration Tool 설치
    • 사전 준비 사항
    • Migration Tool 설치
    • Salesforce Ant Task 구조
    • 실행 환경 구성
  • 참고 문헌
  • 지원 업체

Apache Ant를 사용하여 Apex Code를 deploy, undeploy하는 Windows 콘솔 기반의 Force.com 마이그레이션 도구인 Force.com Migration Tool을 정리 합니다.

 

Force.com Migration Tool 설치

사전 준비 사항

 
 

Migration Tool 설치

  • "설정 -> App 설정 -> 개발 -> 도구" 메뉴에서 "Force.com 마이그레이션 도구" 링크를 선택 하여 설치 프로그램(salesforce_ant_23.0.zip)을 다운로드 합니다.

    • 다운로드 받은 파일의 압축을 풀어서 저장 합니다.

    • ant-salesforce.jar 파일을 $ANT_HOME/lib/ 폴더로 복사 합니다.

 
 

Salesforce Ant Task 구조

  • 디렉토리 구조 및 파일 구조

    • build.properties

      • sf.username에 세일즈포스닷컴 로그인 아이디를 설정한다.

      • sf.password에 세일즈포스닷컴 로그인 암호를 설정한다. Windows에서 작업을 하므로 암호뒤에 보안 토큰을 붙여서 사용하여야 한다.
        보안 토큰은 세일즈포스닷컴에 로그인하여 "설정 -> 개인 설정 -> 내 개인 정보 -> 내 보안 토큰 재설정" 메뉴에서 새로 발급할 수 있다.

    • build.xml

 
 
     
         SampleDeployClass : 여기에 deploy시 Trigger를 테스트할 Class를 지정한다.

:deployroot는 설치할 패키지명(폴더명)을 지정한다. 
:예를 들어 계정(account)과 관련된 Apex Code의 경우 account로 설정을 하고 $ApexCode_HOME/account 폴더를 만들어 작업을 한다. :runTest에 Trigger를 테스트할 Class를 지정한다.

 

:deployroot는 삭제할 패키지명(폴더명)을 지정한다. 
:예를 들어 계정(account)과 관련된 Apex Code의 경우 accountRemove로 설정을 하고 accountRemove 폴더를 만들어 작업을 한다.

 

  • codepkg 디렉토리

    • 도스창에서 ant deploy 명령을 사용하여 Apex Code를 deploy한다.

    • package.xml 파일
      :fullName에 deploy시에 사용할 팩키지명(폴더명)을 지정한다.

 
     SampleDeployClass      : 여기에 deploy할 Class를 지정한다.
     SampleFailingTestClass : 여기에 deploy할 Class를 지정한다.
     ApexClass
 
 
     SampleAccountTrigger : 여기에 deploy할 Trigger를 지정한다.
     ApexTrigger
 

  • classes 폴더 : Apex Code 중 Class 파일을 저장

    • SampleDeployClass.cls : deploy할 Class 파일을 작성한다.

    • SampleDeployClass.cls-meta.xml : 수정하지 않고 그대로 사용한다.

     

  • triggers 폴더 : Apex Code 중 Trigger 파일을 저장

    • SampleAccountTrigger.trigger : deploy할 Trigger 파일을 작성한다.

    • SampleAccountTrigger.trigger-meta.xml : 수정하지 않고 그대로 사용한다.

     

  • removecodepkg 디렉토리

    • 도스창($ApexCode_HOME)에서 ant undeploy 명령을 사용하여 Apex Code를 undeploy한다.

    • package.xml 파일
      :fullName을 deploy시에 사용한 fullName으로 수정한다.

    • destructiveChanges.xml 파일
      :deploy시에 사용한 package.xml 파일의 내용을 여기에 복사한다. 만일 전체를 삭제하지 않을 경우에는 members 중에서 삭제할 members만 남겨둔다.

 

실행 환경 구성

Force.com Migration Tool의 실행 환경을 구성 합니다.

 

  • build.properties

 
 sf.serverurl = https://login.salesforce.com
 sf.username = 로그인 아이디
 sf.password = 비밀번호
 

  • build.xml

 
 

  • Force.com Migration Tool 실행

 
 ant deployTest
 

참고 문헌

지원 업체

{{지원업체}} 
[[Category:Salesforce|Category:Salesforce]]
[[Category:CRM|Category:CRM]]
분류: Cloud

최종 수정일: 2024-09-30 12:26:18
이전글 :
다음글 :