Red Hat Summit6.4. Fuse Online 공용 API 내보내기 끝점 호출
외부 도구를 사용하여 Fuse Online 환경에서 다른 Fuse Online 환경으로 Fuse Online 통합을 복사하려면 먼저 다음 작업을 완료해야 합니다.
Fuse Online에서는 CI/CD 파이프라인을 위해 내보내려는 통합이 특정 환경에 맞게 표시되어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.
이 요구 사항에는 예외가 있습니다. 하나의 내보내기 작업으로 Fuse Online 환경의 모든 통합을 내보내려는 경우 통합이 특정 환경에 대해 이미 표시되어 있는지 여부는 중요하지 않습니다.
- Fuse Online 공용 API를 노출했습니다. 외부 툴은 Fuse Online 공용 API 끝점 사용을 참조하십시오.
특정 환경의 통합 내보내기를 위한 끝점
특정 환경에 대해 표시된 통합을 내보내기 위해 Fuse Online에서는 다음과 같은 GET 메서드 엔드포인트를 제공합니다.
/public/integrations/{env}/export.zip
{env} 를 이미 생성한 CI/CD 환경 레이블로 교체합니다. 특정 환경에 대한 통합이 표시되면 Fuse Online에서 표시 시기를 나타내는 타임스탬프를 유지 관리합니다. 기본 동작은 엔드포인트가 표시된 이후 내보낸 경우에만 통합을 내보낼 수 있다는 것입니다. 예를 들어 test1 환경에 표시된 통합을 내보내려면 끝점은 다음과 같습니다.
/public/integrations/test1/export.zip
이 끝점은 test1 환경 레이블이 있고 다음 조건 중 하나를 충족하는 각 통합을 내보냅니다.
-
마지막으로 내보낸 이후
test1환경에 대한 통합이 표시되었습니다. -
통합이
test1환경에 대해 표시되었으며 내보낸 적이 없습니다.
엔드포인트는 export.zip 파일에 통합을 패키지하고 해당 파일을 반환합니다.
통합이 마지막으로 내보낸 후 지정된 환경에 대해 표시된 통합이 없는 경우 끝점은 HTTP 204 응답을 반환하지 않음을 나타냅니다.
지정된 환경에 태그된 모든 통합을 내보내기 위한 끝점
지정한 환경 레이블로 태그된 Fuse Online 환경의 모든 통합을 내보내도록 내보내기 엔드포인트를 호출할 수 있습니다. 엔드포인트는 통합이 마지막으로 내보낸 이후 지정된 환경에 대해 표시되었는지 여부에 관계없이 통합을 내보냅니다. 이를 통해 다른 Fuse Online 환경에서 특정 태그가 있는 모든 통합을 쉽게 복제할 수 있습니다. 이렇게 하려면 다음을 수행합니다.
- 환경 레이블이 이미 생성되어 있어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.
-
ignoreTimestamp=true옵션을 내보내기 엔드포인트 호출에 추가합니다.
예를 들면 다음과 같습니다.
/public/integrations/test1/export.zip?ignoreTimestamp=true -o export.zip
모든 통합을 내보내기 위한 끝점
내보내기 엔드포인트를 호출하여 하나의 Fuse Online 환경에서 모든 통합을 내보낼 수 있습니다. 따라서 다른 Fuse Online 환경에서 모든 통합을 쉽게 복제할 수 있습니다. 이렇게 하려면 다음을 수행합니다.
- 환경 레이블이 이미 생성되어 있어야 합니다. CI/CD에 대한 통합 표시를 참조하십시오.
-
all=true옵션을 내보내기 엔드포인트 호출에 추가합니다.
예를 들면 다음과 같습니다.
/public/integrations/{env}/export.zip?all=true
{env} 를 CI/CD 환경 레이블로 교체합니다. 엔드포인트는 해당 환경에 아직 표시되지 않은 각 통합에 지정된 환경 레이블을 할당합니다.
all=true 옵션을 추가할 때 내보낸 통합을 export.zip 파일에 패키징하도록 명시적으로 지정해야 합니다. 예를 들면 다음과 같습니다.
/public/integrations/test1/export.zip?all=true -o export.zip
이 끝점 호출:
-
test1환경에 대한 각 통합을 표시합니다. export.zip파일의 모든 통합을 반환합니다.-o export.zip옵션을 지정하지 않으면 엔드포인트에서 이름이export.zip?all=true인 파일을 반환합니다.
내보내기 끝점에 필요한 사용자 정의 헤더
내보내기 끝점을 호출하는 명령은 다음과 같이 이러한 사용자 지정 헤더를 지정해야 합니다.
-
-h "Content-Type: multipart/form-data" -h "SYNDESIS-XSRF-TOKEN: SYNDESIS-XSRF-TOKEN"Fuse Online 공용 API를 사용하려면 이 헤더가 요청을 인증해야 합니다.
-h 'Authorization: Bearer <token>'&
lt;token>을 Fuse Online 공용 API를 노출하는 데 사용되는 OpenShift 서비스 계정을 생성할 때 파일에 복사한 시크릿 토큰으로 바꿉니다.
통합을 내보내는 샘플 curl 명령
다음은 통합을 내보내는 Fuse Online API 엔드포인트를 호출하는 curl 명령의 예입니다.
curl -v -k -L -H "Content-Type: multipart/form-data" -H "SYNDESIS-XSRF-TOKEN: awesome" -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA' https://public-syndesis.192.168.64.42.nip.io/api/v1/public/integrations/dev1/export.zip
curl -v -k -L -H "Content-Type: multipart/form-data" -H "SYNDESIS-XSRF-TOKEN: awesome" -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJzeW5kZXNpcyIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VjcmV0Lm5hbWUiOiJzeW5kZXNpcy1jZC1jbGllbnQtdG9rZW4tMnZjNmwiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlcnZpY2UtYWNjb3VudC5uYW1lIjoic3luZGVzaXMtY2QtY2xpZW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiNjUxMjYxNGMtMmYwMS0xMWU5LTk3OWEtNDI1YWNlMzY3MTcyIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OnN5bmRlc2lzOnN5bmRlc2lzLWNkLWNsaWVudCJ9.uKsri0JSKJDbgHoQwAhBJSNuWKwJgjegf2QlrCkhxVssSK1zIMZQaF9P5a4R7ZcWRnrZ_345UTqxYVeRlfHWVH0PqBkD-n7PAS9dcKJIFdS1jUHOmL1FTGgc3YW-bz1SlWT93tvK1EhorZ4_-EBfXhSAP4Uumi5qAg3_QUTMDstq233NSwBKYtFOw3Pp1ys3p3y0hcaiLMimeCH60vR4iWvptqqzc5QDigHiPySZNWxs_5awZlwdoIDvR-nSj690aC-49UKFgyEEdzdFU4bI2W4hOyDyhN9fVaIAZQKeJUrJBU-lnFTHI_NAd2OwzOEBpWZuj31Za5w9fU4kf4UDGA'
https://public-syndesis.192.168.64.42.nip.io/api/v1/public/integrations/dev1/export.zip명령에서 다음을 수행합니다.
- 명령 끝에 있는 URL은 통합을 내보낼 Fuse Online 환경을 식별합니다.
-
dev1환경 레이블의 사양은dev1환경에 대해 표시된 통합을 내보내고 표시된 이후 아직 내보내지 않았음을 나타냅니다.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}