Document toolboxDocument toolbox

업로드 인벤토리

인벤토리 템플릿 포멧을 엑셀 템플릿 형태로 다운로드 받아, 업로드 할 수 있습니다.

이후 업로드된 파일은 자동 분석되어 각 서비스, 서버, 미들웨어, 애플리케이션, 데이터베이스에 리스트로 보여지게 됩니다.

업로드 시, 파일 데이터의 정상 여부에 따라 리스트에 업로드 상태가 기록되게 되며 업로드 성공 시 업로드 이력을 확인 할 수 있습니다

 

 

업로드 파일

화면에서 파일을 업로드 하는 방법은 두가지가 있습니다.

최초에 Playce RoRo 설치 후 리스트에 업로드 된 파일이 없을 경우 리스트에서 클릭하여 생성된 팝업 화면에서 파일추가 하는 방법과,

상단의 업로드 파일 버튼을 눌러 팝업에서 다운로드 한 파일을 업로드 하는 방법이 있습니다.

해당 파일의 내용을 수정 하는 것은 문제가 발생하지 않으나, 파일의 확장자를 수정할 경우 문제가 발생할 수 있습니다. 업로드 인벤토리에서 지원 하는 확장자의 경우 .xlsx/.xls 두가지 이며 다른 확장자일 경우 이용 할 수 없습니다.

 

 

간단한 인벤토리 업로드 절차는 아래와 같습니다.

  1. 업로드 파일 버튼을 클릭합니다.

  2. 생성된 팝업(업로드 파일)에서 파일 추가를 클릭합니다.

  3. 파일 탐색 혹은 디렉터리 폴더에서 업로드할 엑셀 템플릿 파일을 첨부합니다.

  4. 첨부된 엑셀 템플릿 파일에 대하여 유효성 검사가 실행됩니다.

    1. 유효성 검사 결과 '실패' 시 → 유효성 검사 결과를 표시하고, 업로드 작업이 실행되지 않음

    2. 유효성 검사 결과 '성공' 시 → 업로드 작업이 실행됨

  5. 업로드 된 이후 각 서버와 미들웨어, 애플리케이션, 데이터베이스는 메뉴로 이동 되며 자동 분석이 시작됩니다.

유효성 검사 결과 '실패' 시 업로드 인벤토리 작업이 실행되지 않으며, 업로드 내역 목록에도 쌓이지 않습니다.

 

유효성 검사 결과 ‘실패’ 시
유효성 검사 결과 ‘성공’ 시 업로드 작업 실행 완료

 

인벤토리 업로드 확인 사항

인벤토리 업로드 전 반드시 아래 사항을 확인 후 시행 되어야 합니다. 참고 후 진행합니다.

 

업로드 프로세스

  • 등록 프로세스는 서비스 - 서버 - 미들웨어 - 애플리케이션 - 데이터베이스 순으로 진행됩니다.

  • 다른 시트에 데이터가 없다고 해서 데이터가 있는 시트의 내용이 업로드에 실패하지는 않습니다.

  • 엑셀 템플릿 시트에 목록 형태로 선택할 수 있는 항목들이 있습니다.

  • 만약 신규로 서비스와 서버를 동시에 생성하려고 할 경우에는 생성할 서비스의 이름으로 배치할 수 있습니다.

    • 예를 들어 A라는 서비스를 처음 생성 시 - A 서비스가 없을 경우,

    • 서비스 아이디(service_ID)는 비워둔 채 서버 / 미들웨어 / 애플리케이션 / 데이터베이스에 A 서비스명(service_name)을 넣고 생성합니다.

 

파일 데이터 등록 / 업데이트

  • 서비스(Services) 이름은 중복해서 업로드 할 수 없습니다, 단 다른 시트의 경우 이름의 중복을 허용합니다

  • 데이터의 업데이트/신규 등록은 ID 데이터 유무를 기반으로 합니다, 즉 ID가 있을 경우 기존에 등록되어 있는 데이터를 신규 데이터로 업데이트를 진행할 수 있습니다.

    • ID가 없을 경우 해당 데이터는 신규 데이터로 판단되어 신규 데이터로 생성합니다.

    • 그렇기 때문에 서비스 ID나 이름 중 하나의 값은 반드시 존재해야 합니다.

  • 각 시트의 필수 컬럼 데이터는 아래 항목을 참고합니다.

 

데이터 입력 시 참고 사항

  • 데이터는 실제 서비스 화면의 필수 값과 동일합니다.

  • 서버 등록 시 인증 유형을 프라이빗 키 파일로 했을 경우 아래와 같이 기록합니다

    • 데이터는 실제 서비스 화면의 필수 값과 동일합니다.

    • 서버 등록 시 인증 유형을 프라이빗 키 파일로 했을 경우 아래와 같이 기록합니다

      • 키 파일 이름 - AWS는 key pair파일의 Name, GCP에서는 SSH key구성 절차를 따라 진행하여 생성된 키의 Name을 등록합니다.

      • 키 파일 경로 - 설치 후 아래와 같은 형태로 디렉터리를 위치를 확인해서 입력 할 수 있습니다.
        입력할 데이터의 예시는 아래와 같습니다.

        /roro/keyFiles/hostIp주소-ramdomNum.pem
      • 키 파일 - .pem , json파일의 data를 모두 입력합니다.
        입력할 데이터의 예시는 아래와 같습니다.

        -----BEGIN RSA PRIVATE KEY----- MIIEogIBAAKCAQEAgUmDbdUjzQ6gdQUj/SdP8T39CrJfxbu++gokz96zzzd123423rwsdfasdfas ---------------------------------------------------------------------------- ---------------------------------------------------------------------------- fy3UshII1MLUs3xEHHNxRQOZqniWKwC6SDo51zLUQCLsNEeE9KZyIp76mR1rE0BNXcE= -----END RSA PRIVATE KEY-----

         

기타

  • 시트에 데이터만 삭제 하는 것이 아니라 업로드 할때 데이터를 업로드 하지 않을 시트는 서식까지 모두 삭제(행 제거)해 주시기 바랍니다.

  • Sheet의 데이터를 빼거나, 수정/삭제 해서는 안됩니다.

  • Sheet에 데이터가 없는 빈 Row를 통해 업로드를 시도할 경우 업로드에 실패할 수 있습니다

  • Sheet에 동일한 데이터의 Row를 생성해서 업로드를 시도할 경우 업로드에 실패할 수 있습니다.

  • 기존에 있던 서식에 엑셀 서식을 추가로 변경하거나 수정할 경우 업로드에 실패할 수 있습니다.

 

엑셀 템플릿

엑셀 템플릿 파일을 다운로드 해서 수정 후 이용할 수 있습니다.

파일을 다운로드 할 경우 사용자의 Download directory에 “Inventory_yyyy-MM-dd.xlsx”파일이 신규 생성 됩니다

다운로드 이후, 생성된 파일의 내용을 확인할 경우 필수로 입력해야 하는 값에 대한 설명이 메모에 기록되어 있으며 가이드에 따라 해당하는 열과 행 값을 입력해야 합니다.

 

업로드 리스트

리스트

결과

업로드 상태

업로드 이후 리스트에는 성공 했을 경우 성공 로, 실패 했을 경우 실패 로 보이게 됩니다.

  • 성공 - 업로드 과정을 성공적으로 완료한 상태입니다.

  • 실패 - 업로드 과정에서 서버 에러(수학적 나누기 연산이 /0으로 하는 등) 문제로 업로드 과정이 실패한 상태입니다.

업로드 레코드

업로드에 성공한 Row를 설명합니다.

파일 다운로드

파일 다운로드를 통해 업로드 작업을 실행한 파일을 다운로드 할 수 있습니다.

 

 

<span id="pageNum"/>